Point readers to user documentation (#190)

Encourage users to read the user documentation instead of these developer instructions. Another measures to prevent users from accidental charges.

Author: jkohen

kube/README.md

@@ -1,7 +1,6 @@
 # Kubernetes setup
 
-This directory contains patch scripts to inject the Prometheus sidecar into
-existing Prometheus installations and to deploy a full example setup.
+This directory contains patch scripts to configure the Stackdriver Prometheus integration to work with the Prometheus server. See the [user documentation](https://cloud.google.com/monitoring/kubernetes-engine/prometheus) for more details.
 
 Required environment variables:
 * `KUBE_NAMESPACE`: namespace to run the script against
@@ -42,8 +41,7 @@ Injects sidecar into Prometheus deployments controlled by the [prometheus-operat
 
 ## `full/deploy.sh`
 
-Deploys a basic Prometheus deployment to monitor Kubernetes components and
-custom services that are annotated with the well-known `prometheus.io/*` annotations.
+Deploys a basic Prometheus deployment that generates metric data useful for testing. This setup may incur charges and isn't intended for use in production.
 
 ```sh
 ./full/deploy.sh

kube/full/deploy.sh

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Deploys a basic Prometheus deployment that generates metric data for testing.
 
 set -e
 set -u
@@ -9,7 +10,7 @@ pushd "$(dirname "$0")"
 export SIDECAR_IMAGE_TAG=${SIDECAR_IMAGE_TAG:-'master'}
 export KUBE_NAMESPACE=${KUBE_NAMESPACE:-'default'}
 
-echo "Deploy to namespace ${KUBE_NAMESPACE} for Stackdriver project ${GCP_PROJECT} (location=${GCP_REGION}, cluster=${KUBE_CLUSTER})"
+echo "Deploying test environment to namespace ${KUBE_NAMESPACE} for Stackdriver project ${GCP_PROJECT} (location=${GCP_REGION}, cluster=${KUBE_CLUSTER})"
 
 envsubst < prometheus.yaml > _prometheus.yaml.tmp
 envsubst < node-exporter.yaml > _node-exporter.yaml.tmp