Reorganization of the custom configuration

Jonathan S. Katz · jkatz · commit 248745ec4b03 · 2020-04-29T16:35:35.000-04:00
This brings it further up the funnel so people can find it, given
it is a fairly important and common task.
diff --git a/README.md b/README.md
@@ -77,6 +77,7 @@ The Crunchy PostgreSQL Operator makes it easy to get your own PostgreSQL-as-a-Se
 - Selecting different storage classes for your primary, replica, and backup storage
 - Select your own container resources class for each PostgreSQL cluster deployment; differentiate between resources applied for primary and replica clusters!
 - Use your own container image repository, including support `imagePullSecrets` and private repositories
+- [Customize your PostgreSQL configuration](https://access.crunchydata.com/documentation/postgres-operator/latest/advanced/custom-configuration.md)
 - Bring your own trusted certificate authority (CA) for use with the Operator API server
 - Override your PostgreSQL configuration for each cluster
 
diff --git a/docs/content/_index.md b/docs/content/_index.md
@@ -82,6 +82,7 @@ The Crunchy PostgreSQL Operator makes it easy to get your own PostgreSQL-as-a-Se
 - Selecting different storage classes for your primary, replica, and backup storage
 - Select your own container resources class for each PostgreSQL cluster deployment; differentiate between resources applied for primary and replica clusters!
 - Use your own container image repository, including support `imagePullSecrets` and private repositories
+- [Customize your PostgreSQL configuration]({{< relref "/advanced/custom-configuration.md" >}})
 - Bring your own trusted certificate authority (CA) for use with the Operator API server
 - Override your PostgreSQL configuration for each cluster
 
diff --git a/docs/content/advanced/custom-configuration.md b/docs/content/advanced/custom-configuration.md
diff --git a/docs/content/architecture/provisioning.md b/docs/content/architecture/provisioning.md
@@ -112,6 +112,22 @@ deleted
 - The Kubernetes Deployment associated with the replica is removed, as well as
 any other Kubernetes objects that are specifically associated with this replcia
 
+## [Custom Configuration]({{< relref "/advanced/custom-configuration.md" >}})
+
+PostgreSQL workloads often need tuning and additional configuration in production
+environments, and the PostgreSQL Operator allows for this via its ability to
+manage [custom PostgreSQL configuration]({{< relref "/advanced/custom-configuration.md" >}}).
+
+The custom configuration can be edit from a [ConfigMap](https://kubernetes.io/docs/concepts/configuration/configmap/)
+that follows the pattern of `<clusterName>-pgha-config`, where `<clusterName>`
+would be `hippo` in `pgo create cluster hippo`. When the ConfigMap is edited,
+the changes are automatically pushed out to all of the PostgreSQL instances
+within a cluster.
+
+For more information on how this works and what configuration settings are
+editable, please visit the "[Custom PostgreSQL configuration]({{< relref "/advanced/custom-configuration.md" >}})"
+section of the documentation.
+
 ## Deprovisioning
 
 There may become a point where you need to completely deprovision, or delete, a
diff --git a/docs/content/pgo-client/common-tasks.md b/docs/content/pgo-client/common-tasks.md
@@ -1028,6 +1028,15 @@ If you try to connect to a PostgreSQL cluster that is deployed using the
 `--tls-only` with TLS disabled (i.e. `PGSSLMODE=disable`), you will receive an
 error that connections without TLS are unsupported.
 
+## [Custom PostgreSQL Configuration]({{< relref "/advanced/custom-configuration.md" >}})
+
+Customizing PostgreSQL configuration is currently not subject to the `pgo`
+client, but given it is a common question, we thought it may be helpful to link
+to how to do it from here. To find out more about how to
+[customize your PostgreSQL configuration]({{< relref "/advanced/custom-configuration.md" >}}),
+please refer to the [Custom PostgreSQL Configuration]({{< relref "/advanced/custom-configuration.md" >}})
+section of the documentation.
+
 ## Standby Clusters: Multi-Cluster Kubernetes Deployments
 
 A [standby PostgreSQL cluster]({{< relref "/architecture/high-availability/multi-cluster-kubernetes.md" >}})
