Documentation adjustments

Author: Jonathan S. Katz

hugo/content/Upgrade/_index.md

@@ -40,4 +40,4 @@ In this example, we are upgrading a cluster from PostgreSQL 11.5 to 11.6 using t
 
 `pgo upgrade mycluster --ccp-image-tag=centos7-11.6-4.2.0`
 
-For more information, please see the `pgo upgrade` documentation [here.] ( {{< relref "pgo-cli/reference/pgo_upgrade.md" >}})
+For more information, please see the `pgo upgrade` documentation [here.] ( {{< relref "pgo-client/reference/pgo_upgrade.md" >}})

hugo/content/advanced/direct-api-calls.md

@@ -11,7 +11,7 @@ The API can also be accessed by interacting directly with the API server. This c
 
 The most basic example of this interaction is getting the version of the API server. You can send a GET request to `$PGO_APISERVER_URL/version` and this will send back a json response including the API server version. This is important because the server version and the client version must match. If you are using `pgo` this means you must have the correct version of the client but with a direct call you can specify the client version as part of the request.
 
-The API server is setup to work with the pgo command line interface so the parameters that are passed to the server can be found by looking at the related flags. For example, the series parameter used in the `create` example below is the same as the `-e, --series` flag that is described in the [pgo cli docs](https://access.crunchydata.com/documentation/postgres-operator/4.2.0/pgo-cli/reference/pgo_create_cluster/).
+The API server is setup to work with the pgo command line interface so the parameters that are passed to the server can be found by looking at the related flags. For example, the series parameter used in the `create` example below is the same as the `-e, --series` flag that is described in the [pgo cli docs](https://access.crunchydata.com/documentation/postgres-operator/4.2.0/pgo-client/reference/pgo_create_cluster/).
 
 ###### Get API Server Version
 ```

hugo/content/architecture/disaster-recovery.md

@@ -89,7 +89,7 @@ The PostgreSQL Operator supports the ability to perform a full restore on a
 PostgreSQL cluster as well as a point-in-time-recovery using the `pgo restore`
 command. Note that both of these options are **destructive** to the existing
 PostgreSQL cluster; to "restore" the PostgreSQL cluster to a new deployment,
-please see the [Clone](/pgo-cli/common-tasks/#clone-a-postgresql-cluster) section.
+please see the [Clone](/pgo-client/common-tasks/#clone-a-postgresql-cluster) section.
 
 The `pgo restore` command lets you specify the point at which you want to
 restore your database using the `--pitr-target` flag with the `pgo restore`

hugo/content/pgo-cli/reference/_index.md

@@ -147,5 +147,5 @@ one needs to perform when managing production PostgreSQL clusters. Beyond that
 is the full reference for all the available commands and flags for the `pgo`
 client.
 
-- [Common `pgo` Client Tasks](/pgo-cli/common-tasks/)
-- [`pgo` Client Reference](/pgo-cli/common-reference/)
+- [Common `pgo` Client Tasks](/pgo-client/common-tasks/)
+- [`pgo` Client Reference](/pgo-client/common-reference/)

hugo/content/pgo-cli/reference/pgo_show.md

@@ -5,7 +5,7 @@ draft: false
 weight: 20
 ---
 
-While the full [`pgo` client reference](/pgo-cli/reference/) will tell you
+While the full [`pgo` client reference](/pgo-client/reference/) will tell you
 everything you need to know about how to use `pgo`, it may be helpful to see
 several examples on how to conduct "day-in-the-life" tasks for administrating
 PostgreSQL cluster with the PostgreSQL Operator.
@@ -24,7 +24,7 @@ onerous for the intents of this guide.
 If you install the PostgreSQL Operator using the [quickstart](/quickstart/)
 guide, you will have two namespaces installed: `pgouser1` and `pgouser2`. We
 can choose to always use one of these namespaces by setting the `PGO_NAMESPACE`
-environmental variable, which is detailed in the global [`pgo` Client](/pgo-cli/)
+environmental variable, which is detailed in the global [`pgo` Client](/pgo-client/)
 reference,
 
 For convenience, we will use the `pgouser1` namespace in the examples below.
@@ -74,7 +74,7 @@ environment.
 ### Checking Connectivity to the PostgreSQL Operator
 
 A common task when working with the PostgreSQL Operator is to check connectivity
-to the PostgreSQL Operator. This can be accomplish with the [`pgo version`](/pgo-cli/reference/pgo_version/)
+to the PostgreSQL Operator. This can be accomplish with the [`pgo version`](/pgo-client/reference/pgo_version/)
 command:
 
 ```shell
@@ -90,7 +90,7 @@ pgo-apiserver version 4.2.0
 
 ### Inspecting the PostgreSQL Operator Configuration
 
-The [`pgo show config`](/pgo-cli/reference/pgo_status/) command allows you to
+The [`pgo show config`](/pgo-client/reference/pgo_status/) command allows you to
 view the current configuration that the PostgreSQL Operator is using. This can
 be helpful for troubleshooting issues such as which PostgreSQL images are being
 deployed by default, which storage classes are being used, etc.
@@ -177,7 +177,7 @@ DefaultPgbouncerResources: ""
 
 ### Viewing PostgreSQL Operator Key Metrics
 
-The [`pgo status`](/pgo-cli/reference/pgo_status/) command provides a
+The [`pgo status`](/pgo-client/reference/pgo_status/) command provides a
 generalized statistical view of the overall resource consumption of the
 PostgreSQL Operator. These stats include:
 
@@ -248,7 +248,7 @@ know which namespaces the PostgreSQL Operator can use for deploying PostgreSQL
 clusters.
 
 You can view which namespaces the PostgreSQL Operator can utilize by using
-the [`pgo show namespace`](/pgo-cli/reference/pgo_show_namespace/) command. To
+the [`pgo show namespace`](/pgo-client/reference/pgo_show_namespace/) command. To
 list out the namespaces that the PostgreSQL Operator has access to, you can run
 the following command:
 
@@ -281,7 +281,7 @@ described in the [general notes](#general-notes) on this page.
 
 ### Creating a PostgreSQL Cluster
 
-You can create a cluster using the [`pgo create cluster`](/pgo-cli/reference/pgo_create_cluster/)
+You can create a cluster using the [`pgo create cluster`](/pgo-client/reference/pgo_create_cluster/)
 command:
 
 ```shell
@@ -309,7 +309,7 @@ pgo create cluster hagiscluster --ccp-image=crunchy-postgres-gis-ha
 A new PostgreSQL cluster can take a few moments to provision. You may have
 noticed that the `pgo create cluster` command returns something called a
 "workflow id". This workflow ID allows you to track the progress of your new
-PostgreSQL cluster while it is being provisioned using the [`pgo show workflow`](/pgo-cli/reference/pgo_show_workflow/)
+PostgreSQL cluster while it is being provisioned using the [`pgo show workflow`](/pgo-client/reference/pgo_show_workflow/)
 command:
 
 ```shell
@@ -329,7 +329,7 @@ workflowid          ae714d12-f5d0-4fa9-910f-21944b41dec8
 
 ### View PostgreSQL Cluster Details
 
-To see details about your PostgreSQL cluster, you can use the [`pgo show cluster`](/pgo-cli/reference/pgo_show_cluster/)
+To see details about your PostgreSQL cluster, you can use the [`pgo show cluster`](/pgo-client/reference/pgo_show_cluster/)
 command. These details include elements such as:
 
 - The version of PostgreSQL that the cluster is using
@@ -403,7 +403,7 @@ pgo delete cluster hacluster --keep-backups
 
 ## Testing PostgreSQL Cluster Availability
 
-You can test the availability of your cluster by using the [`pgo test`](/pgo-cli/reference/pgo_test/)
+You can test the availability of your cluster by using the [`pgo test`](/pgo-client/reference/pgo_test/)
 command. The `pgo test` command checks to see if the Kubernetes Services and
 the Pods that comprise the PostgreSQL cluster are available to receive
 connections. This includes:
@@ -593,7 +593,7 @@ pgo restore hacluster --node-label=failure-domain.beta.kubernetes.io/zone=us-cen
 
 There are very few reasons why you will want to execute a full restore. If you
 want to make a copy of your PostgreSQL cluster, please use
-[`pgo clone`](/pgo-cli/reference/pgo_clone).
+[`pgo clone`](/pgo-client/reference/pgo_clone).
 
 #### Point-in-time-Recovery (PITR)
 
@@ -762,7 +762,7 @@ destroy.
 ## Clone a PostgreSQL Cluster
 
 You can create a copy of an existing PostgreSQL cluster in a new PostgreSQL
-cluster by using the [`pgo clone`](/pgo-cli/reference/pgo_clone/) command. To
+cluster by using the [`pgo clone`](/pgo-client/reference/pgo_clone/) command. To
 create a new copy of a PostgreSQL cluster, you can execute the following
 command:
 
@@ -781,32 +781,39 @@ volume claim size by entering the following:
 pgo df hacluster -n pgouser1
 ```
 
-### Label Operations
+## Labels
 
-#### Apply a Label to a Cluster
+Labels are a helpful way to organize PostgreSQL clusters, such as by application
+type or environment. The PostgreSQL Operator supports managing Kubernetes Labels
+as a convenient way to group PostgreSQL clusters together.
 
-You can apply a Kubernetes label to a Postgres cluster as follows:
+You can view which labels are assigned to a PostgreSQL cluster using the
+[`pgo show cluster`](/pgo-client/reference/pgo_show_cluster/) command. You are also
+able to see these labels when using `kubectl` or `oc`.
 
-    pgo label hacluster --label=environment=prod -n pgouser1
+### Add a Label to a PostgreSQL Cluster
 
-In this example, the label key is *environment* and the label
-value is *prod*.
+Labels can be added to PostgreSQL clusters using the [`pgo label`](/pgo-client/reference/pgo_label/)
+command. For example, to add a label with a key/value pair of `env=production`,
+you could execute the following command:
 
-You can apply labels across a category of Postgres clusters by
-using the *--selector* command flag as follows:
-
-    pgo label --selector=clustertypes=research --label=environment=prod -n pgouser1
+```shell
+pgo label hacluster --label=env=production
+```
 
-In this example, any Postgres cluster with the label of *clustertypes=research*
-will have the label *environment=prod* set.
+### Add a Label to Multiple PostgreSQL Clusters
 
-In the following command, you can also view Postgres clusters by
-using the *--selector* command flag which specifies a label key value
-to search with:
+You can add also add a label to multiple PostgreSQL clusters simultaneously
+using the `--selector` flag on the `pgo label` command. For example, to add a
+label with a key/value pair of `env=production` to clusters that have a label
+key/value pair of `app=payment`, you could execute the following command:
 
-    pgo show cluster --selector=environment=prod -n pgouser1
+```shell
+pgo label --selector=app=payment --label=env=production
+```
 
 ## Policy Management
+
 ### Create a Policy
 
 To create a SQL policy, enter the following:

hugo/content/pgo-cli/_index.md hugo/content/pgo-client/_index.mdhugo/content/pgo-cli/_index.md renamed to hugo/content/pgo-client/_index.md

@@ -0,0 +1,52 @@
+---
+title: "pgo Client Reference"
+---
+## pgo
+
+The pgo command line interface.
+
+### Synopsis
+
+The pgo command line interface lets you create and manage PostgreSQL clusters.
+
+### Options
+
+```
+      --apiserver-url string     The URL for the PostgreSQL Operator apiserver that will process the request from the pgo client.
+      --debug                    Enable additional output for debugging.
+      --disable-tls              Disable TLS authentication to the Postgres Operator.
+      --exclude-os-trust         Exclude CA certs from OS default trust store
+  -h, --help                     help for pgo
+  -n, --namespace string         The namespace to use for pgo requests.
+      --pgo-ca-cert string       The CA Certificate file path for authenticating to the PostgreSQL Operator apiserver.
+      --pgo-client-cert string   The Client Certificate file path for authenticating to the PostgreSQL Operator apiserver.
+      --pgo-client-key string    The Client Key file path for authenticating to the PostgreSQL Operator apiserver.
+```
+
+### SEE ALSO
+
+* [pgo apply](/pgo-client/reference/pgo_apply/)	 - Apply a policy
+* [pgo backup](/pgo-client/reference/pgo_backup/)	 - Perform a Backup
+* [pgo benchmark](/pgo-client/reference/pgo_benchmark/)	 - Perform a pgBench benchmark against clusters
+* [pgo cat](/pgo-client/reference/pgo_cat/)	 - Perform a cat command on a cluster
+* [pgo clone](/pgo-client/reference/pgo_clone/)	 - Copies the primary database of an existing cluster to a new cluster
+* [pgo create](/pgo-client/reference/pgo_create/)	 - Create a Postgres Operator resource
+* [pgo delete](/pgo-client/reference/pgo_delete/)	 - Delete an Operator resource
+* [pgo df](/pgo-client/reference/pgo_df/)	 - Display disk space for clusters
+* [pgo failover](/pgo-client/reference/pgo_failover/)	 - Performs a manual failover
+* [pgo label](/pgo-client/reference/pgo_label/)	 - Label a set of clusters
+* [pgo load](/pgo-client/reference/pgo_load/)	 - Perform a data load
+* [pgo ls](/pgo-client/reference/pgo_ls/)	 - Perform a ls command on a cluster
+* [pgo reload](/pgo-client/reference/pgo_reload/)	 - Perform a cluster reload
+* [pgo restore](/pgo-client/reference/pgo_restore/)	 - Perform a restore from previous backup
+* [pgo scale](/pgo-client/reference/pgo_scale/)	 - Scale a PostgreSQL cluster
+* [pgo scaledown](/pgo-client/reference/pgo_scaledown/)	 - Scale down a PostgreSQL cluster
+* [pgo show](/pgo-client/reference/pgo_show/)	 - Show the description of a cluster
+* [pgo status](/pgo-client/reference/pgo_status/)	 - Display PostgreSQL cluster status
+* [pgo test](/pgo-client/reference/pgo_test/)	 - Test cluster connectivity
+* [pgo update](/pgo-client/reference/pgo_update/)	 - Update a pgouser, pgorole, or cluster
+* [pgo upgrade](/pgo-client/reference/pgo_upgrade/)	 - Perform an upgrade
+* [pgo version](/pgo-client/reference/pgo_version/)	 - Print version information for the PostgreSQL Operator
+* [pgo watch](/pgo-client/reference/pgo_watch/)	 - Print watch information for the PostgreSQL Operator
+
+###### Auto generated by spf13/cobra on 31-Dec-2019

hugo/content/pgo-cli/common-tasks.md hugo/content/pgo-client/common-tasks.mdhugo/content/pgo-cli/common-tasks.md renamed to hugo/content/pgo-client/common-tasks.md

@@ -28,8 +28,8 @@ pgo apply [flags]
 ### Options inherited from parent commands
 
 ```
-      --apiserver-url string     The URL for the PostgreSQL Operator apiserver.
-      --debug                    Enable debugging when true.
+      --apiserver-url string     The URL for the PostgreSQL Operator apiserver that will process the request from the pgo client.
+      --debug                    Enable additional output for debugging.
       --disable-tls              Disable TLS authentication to the Postgres Operator.
       --exclude-os-trust         Exclude CA certs from OS default trust store
   -n, --namespace string         The namespace to use for pgo requests.
@@ -40,6 +40,6 @@ pgo apply [flags]
 
 ### SEE ALSO
 
-* [pgo](/pgo-cli/reference/pgo/)	 - The pgo command line interface.
+* [pgo](/pgo-client/reference/pgo/)	 - The pgo command line interface.
 
-###### Auto generated by spf13/cobra on 27-Dec-2019
+###### Auto generated by spf13/cobra on 31-Dec-2019