Update docs for v1.2 (#609)

* update docs and move parts from README to index.md
* fix typos, headings and code alignment in docs

charts/postgres-operator/Chart.yaml

@@ -3,7 +3,7 @@ name: postgres-operator
 version: 1.2.0
 appVersion: 1.2.0
 home: https://github.com/zalando/postgres-operator
-description: Postgres operator creates and manages PostgreSQL clusters running in Kubernetes
+description: Postgres Operator creates and manages PostgreSQL clusters running in Kubernetes
 keywords:
 - postgres
 - operator
@@ -16,5 +16,5 @@ maintainers:
 - name: kimxogus
   email: kgyoo8232@gmail.com
 sources:
-- https://github.com/zalando-incubator/postgres-operator
+- https://github.com/zalando/postgres-operator
 engine: gotpl

charts/postgres-operator/values-crd.yaml

@@ -243,7 +243,7 @@ serviceAccount:
   create: true
   # The name of the ServiceAccount to use.
   # If not set and create is true, a name is generated using the fullname template
-  # When relying solely on the OperatorConfiguration CRD, set this value to "operator"
+  # When relying solely on the OperatorConfiguration CRD, this value has to be "operator"
   # Otherwise, the operator tries to use the "default" service account which is forbidden
   name: operator
 

charts/postgres-operator/values.yaml

@@ -224,8 +224,6 @@ serviceAccount:
   create: true
   # The name of the ServiceAccount to use.
   # If not set and create is true, a name is generated using the fullname template
-  # When relying solely on the OperatorConfiguration CRD, set this value to "operator"
-  # Otherwise, the operator tries to use the "default" service account which is forbidden
   name:
 
 priorityClassName: ""