Merge pull request #2245 from cblecker/verify-docs

docs(*): Add ci script to confirm docs are up to date with commits

Makefile

@@ -87,11 +87,11 @@ protoc:
 
 .PHONY: docs
 docs: build
-	@mkdir -p docs/helm docs/man/man1
-	bin/helm docs --dir ./docs/helm
-	bin/helm docs --dir ./docs/man/man1 --type man
-	bin/helm docs --dir ./scripts --type bash
-	scripts/docs-clean-home.sh
+	@scripts/update-docs.sh
+
+.PHONY: verify-docs
+verify-docs: build
+	@scripts/verify-docs.sh
 
 .PHONY: clean
 clean:

circle.yml

@@ -3,7 +3,7 @@ machine:
     - curl -sSL https://s3.amazonaws.com/circle-downloads/install-circleci-docker.sh | bash -s -- 1.10.0
 
   environment:
-    GOVERSION: "1.7.4"
+    GOVERSION: "1.7.5"
     GOPATH:  "${HOME}/.go_workspace"
     WORKDIR: "${GOPATH}/src/k8s.io/helm"
     PROJECT_NAME: "kubernetes-helm"

docs/helm/helm.md

@@ -54,15 +54,19 @@ Environment:
 * [helm lint](helm_lint.md)	 - examines a chart for possible issues
 * [helm list](helm_list.md)	 - list releases
 * [helm package](helm_package.md)	 - package a chart directory into a chart archive
+* [helm plugin](helm_plugin.md)	 - add, list, or remove Helm plugins
 * [helm repo](helm_repo.md)	 - add, list, remove, update, and index chart repositories
 * [helm reset](helm_reset.md)	 - uninstalls Tiller from a cluster
+* [helm reset](helm_reset.md)	 - uninstalls Tiller from a cluster
 * [helm rollback](helm_rollback.md)	 - roll back a release to a previous revision
 * [helm search](helm_search.md)	 - search for a keyword in charts
 * [helm serve](helm_serve.md)	 - start a local http web server
 * [helm status](helm_status.md)	 - displays the status of the named release
 * [helm test](helm_test.md)	 - test a release
+* [helm test](helm_test.md)	 - test a release
 * [helm upgrade](helm_upgrade.md)	 - upgrade a release
 * [helm verify](helm_verify.md)	 - verify that a chart at the given path has been signed and is valid
 * [helm version](helm_version.md)	 - print the client/server version information
+* [helm version](helm_version.md)	 - print the client/server version information
 
-###### Auto generated by spf13/cobra on 11-Mar-2017
+###### Auto generated by spf13/cobra on 12-Apr-2017

docs/helm/helm_delete.md

@@ -24,6 +24,11 @@ helm delete [flags] RELEASE_NAME [...]
       --no-hooks             prevent hooks from running during deletion
       --purge                remove the release from the store and make its name free for later use
       --timeout int          time in seconds to wait for any individual kubernetes operation (like Jobs for hooks) (default 300)
+      --tls                  enable TLS for request
+      --tls-ca-cert string   path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
+      --tls-cert string      path to TLS certificate file (default "$HELM_HOME/cert.pem")
+      --tls-key string       path to TLS key file (default "$HELM_HOME/key.pem")
+      --tls-verify           enable TLS for request and verify remote
 ```
 
 ### Options inherited from parent commands
@@ -39,4 +44,4 @@ helm delete [flags] RELEASE_NAME [...]
 ### SEE ALSO
 * [helm](helm.md)	 - The Helm package manager for Kubernetes.
 
-###### Auto generated by spf13/cobra on 11-Mar-2017
+###### Auto generated by spf13/cobra on 12-Apr-2017

docs/helm/helm_dependency.md

@@ -36,20 +36,8 @@ The 'version' field should contain a semantic version or version range.
 
 The 'repository' URL should point to a Chart Repository. Helm expects that by
 appending '/index.yaml' to the URL, it should be able to retrieve the chart
-repository's index.
-
-A repository can also be represented by a repository name defined in the index file
-in lieu of a repository URL. If a repository alias is used, it is expected to start with
-'alias:' or '@', followed by a repository name. For example,
-    # requirements.yaml
-    dependencies:
-    - name: nginx
-      version: "1.2.3"
-      repository: "alias:stable"
-
-Note: In the above example, if the '@' syntax is used, the repository alias '@stable'
-must be quoted, as YAML requires to use quotes if the value includes a special character
-like '@'.
+repository's index. Note: 'repository' cannot be a repository alias. It must be
+a URL.
 
 Starting from 2.2.0, repository can be defined as the path to the directory of
 the dependency charts stored locally. The path should start with a prefix of
@@ -65,6 +53,7 @@ If the dependency chart is retrieved locally, it is not required to have the
 repository added to helm by "helm add repo". Version matching is also supported
 for this case.
 
+
 ### Options inherited from parent commands
 
 ```
@@ -81,4 +70,4 @@ for this case.
 * [helm dependency list](helm_dependency_list.md)	 - list the dependencies for the given chart
 * [helm dependency update](helm_dependency_update.md)	 - update charts/ based on the contents of requirements.yaml
 
-###### Auto generated by spf13/cobra on 11-Mar-2017
+###### Auto generated by spf13/cobra on 12-Apr-2017

docs/helm/helm_get.md

@@ -26,6 +26,11 @@ helm get [flags] RELEASE_NAME
 
 ```
       --revision int32       get the named release with revision
+      --tls                  enable TLS for request
+      --tls-ca-cert string   path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
+      --tls-cert string      path to TLS certificate file (default "$HELM_HOME/cert.pem")
+      --tls-key string       path to TLS key file (default "$HELM_HOME/key.pem")
+      --tls-verify           enable TLS for request and verify remote
 ```
 
 ### Options inherited from parent commands
@@ -44,4 +49,4 @@ helm get [flags] RELEASE_NAME
 * [helm get manifest](helm_get_manifest.md)	 - download the manifest for a named release
 * [helm get values](helm_get_values.md)	 - download the values file for a named release
 
-###### Auto generated by spf13/cobra on 11-Mar-2017
+###### Auto generated by spf13/cobra on 12-Apr-2017

docs/helm/helm_history.md

@@ -29,6 +29,11 @@ helm history [flags] RELEASE_NAME
 
 ```
       --max int32            maximum number of revision to include in history (default 256)
+      --tls                  enable TLS for request
+      --tls-ca-cert string   path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
+      --tls-cert string      path to TLS certificate file (default "$HELM_HOME/cert.pem")
+      --tls-key string       path to TLS key file (default "$HELM_HOME/key.pem")
+      --tls-verify           enable TLS for request and verify remote
 ```
 
 ### Options inherited from parent commands
@@ -44,4 +49,4 @@ helm history [flags] RELEASE_NAME
 ### SEE ALSO
 * [helm](helm.md)	 - The Helm package manager for Kubernetes.
 
-###### Auto generated by spf13/cobra on 11-Mar-2017
+###### Auto generated by spf13/cobra on 12-Apr-2017

docs/helm/helm_init.md

@@ -36,7 +36,13 @@ helm init
       --canary-image             use the canary tiller image
   -c, --client-only              if set does not install tiller
       --dry-run                  do not install local or remote
+      --skip-refresh             do not refresh (download) the local repository cache
   -i, --tiller-image string      override tiller image
+      --tiller-tls               install tiller with TLS enabled
+      --tiller-tls-cert string   path to TLS certificate file to install with tiller
+      --tiller-tls-key string    path to TLS key file to install with tiller
+      --tiller-tls-verify        install tiller with TLS enabled and to verify remote certificates
+      --tls-ca-cert string       path to CA root certificate
       --upgrade                  upgrade if tiller is already installed
 ```
 
@@ -53,4 +59,4 @@ helm init
 ### SEE ALSO
 * [helm](helm.md)	 - The Helm package manager for Kubernetes.
 
-###### Auto generated by spf13/cobra on 11-Mar-2017
+###### Auto generated by spf13/cobra on 12-Apr-2017

docs/helm/helm_install.md

@@ -77,10 +77,15 @@ helm install [CHART]
       --replace                re-use the given name, even if that name is already used. This is unsafe in production
       --set stringArray        set values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
       --timeout int            time in seconds to wait for any individual kubernetes operation (like Jobs for hooks) (default 300)
+      --tls                    enable TLS for request
+      --tls-ca-cert string     path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
+      --tls-cert string        path to TLS certificate file (default "$HELM_HOME/cert.pem")
+      --tls-key string         path to TLS key file (default "$HELM_HOME/key.pem")
+      --tls-verify             enable TLS for request and verify remote
   -f, --values valueFiles      specify values in a YAML file (can specify multiple) (default [])
       --verify                 verify the package before installing it
       --version string         specify the exact chart version to install. If this is not specified, the latest version is installed
-      --wait                   if set, will wait until all Pods, PVCs, and Services are in a ready state before marking the release as successful. It will wait for as long as --timeout
+      --wait                   if set, will wait until all Pods, PVCs, Services, and minimum number of Pods of a Deployment are in a ready state before marking the release as successful. It will wait for as long as --timeout
 ```
 
 ### Options inherited from parent commands
@@ -96,4 +101,4 @@ helm install [CHART]
 ### SEE ALSO
 * [helm](helm.md)	 - The Helm package manager for Kubernetes.
 
-###### Auto generated by spf13/cobra on 11-Mar-2017
+###### Auto generated by spf13/cobra on 12-Apr-2017

docs/helm/helm_list.md

@@ -50,6 +50,11 @@ helm list [flags] [FILTER]
   -o, --offset string        next release name in the list, used to offset from start value
   -r, --reverse              reverse the sort order
   -q, --short                output short (quiet) listing format
+      --tls                  enable TLS for request
+      --tls-ca-cert string   path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
+      --tls-cert string      path to TLS certificate file (default "$HELM_HOME/cert.pem")
+      --tls-key string       path to TLS key file (default "$HELM_HOME/key.pem")
+      --tls-verify           enable TLS for request and verify remote
 ```
 
 ### Options inherited from parent commands
@@ -65,4 +70,4 @@ helm list [flags] [FILTER]
 ### SEE ALSO
 * [helm](helm.md)	 - The Helm package manager for Kubernetes.
 
-###### Auto generated by spf13/cobra on 11-Mar-2017
+###### Auto generated by spf13/cobra on 12-Apr-2017

docs/helm/helm_package.md

@@ -23,6 +23,7 @@ helm package [flags] [CHART_PATH] [...]
 ### Options
 
 ```
+  -d, --destination string   location to write the chart. (default ".")
       --key string           name of the key to use when signing. Used if --sign is true
       --keyring string       location of a public keyring (default "~/.gnupg/pubring.gpg")
       --save                 save packaged chart to local chart repository (default true)
@@ -43,4 +44,4 @@ helm package [flags] [CHART_PATH] [...]
 ### SEE ALSO
 * [helm](helm.md)	 - The Helm package manager for Kubernetes.
 
-###### Auto generated by spf13/cobra on 11-Mar-2017
+###### Auto generated by spf13/cobra on 12-Apr-2017

docs/helm/helm_plugin.md

+## helm plugin
+
+add, list, or remove Helm plugins
+
+### Synopsis
+
+
+
+Manage client-side Helm plugins.
+
+
+### Options inherited from parent commands
+
+```
+      --debug                     enable verbose output
+      --home string               location of your Helm config. Overrides $HELM_HOME (default "~/.helm")
+      --host string               address of tiller. Overrides $HELM_HOST
+      --kube-context string       name of the kubeconfig context to use
+      --tiller-namespace string   namespace of tiller (default "kube-system")
+```
+
+### SEE ALSO
+* [helm](helm.md)	 - The Helm package manager for Kubernetes.
+* [helm plugin install](helm_plugin_install.md)	 - install one or more Helm plugins
+* [helm plugin list](helm_plugin_list.md)	 - list installed Helm plugins
+* [helm plugin remove](helm_plugin_remove.md)	 - remove one or more Helm plugins
+
+###### Auto generated by spf13/cobra on 12-Apr-2017

docs/helm/helm_plugin_install.md

+## helm plugin install
+
+install one or more Helm plugins
+
+### Synopsis
+
+
+install one or more Helm plugins
+
+```
+helm plugin install [options] <path|url>...
+```
+
+### Options
+
+```
+      --version string   specify a version constraint. If this is not specified, the latest version is installed
+```
+
+### Options inherited from parent commands
+
+```
+      --debug                     enable verbose output
+      --home string               location of your Helm config. Overrides $HELM_HOME (default "~/.helm")
+      --host string               address of tiller. Overrides $HELM_HOST
+      --kube-context string       name of the kubeconfig context to use
+      --tiller-namespace string   namespace of tiller (default "kube-system")
+```
+
+### SEE ALSO
+* [helm plugin](helm_plugin.md)	 - add, list, or remove Helm plugins
+
+###### Auto generated by spf13/cobra on 12-Apr-2017

docs/helm/helm_plugin_list.md

+## helm plugin list
+
+list installed Helm plugins
+
+### Synopsis
+
+
+list installed Helm plugins
+
+```
+helm plugin list
+```
+
+### Options inherited from parent commands
+
+```
+      --debug                     enable verbose output
+      --home string               location of your Helm config. Overrides $HELM_HOME (default "~/.helm")
+      --host string               address of tiller. Overrides $HELM_HOST
+      --kube-context string       name of the kubeconfig context to use
+      --tiller-namespace string   namespace of tiller (default "kube-system")
+```
+
+### SEE ALSO
+* [helm plugin](helm_plugin.md)	 - add, list, or remove Helm plugins
+
+###### Auto generated by spf13/cobra on 12-Apr-2017

docs/helm/helm_plugin_remove.md

+## helm plugin remove
+
+remove one or more Helm plugins
+
+### Synopsis
+
+
+remove one or more Helm plugins
+
+```
+helm plugin remove <plugin>...
+```
+
+### Options inherited from parent commands
+
+```
+      --debug                     enable verbose output
+      --home string               location of your Helm config. Overrides $HELM_HOME (default "~/.helm")
+      --host string               address of tiller. Overrides $HELM_HOST
+      --kube-context string       name of the kubeconfig context to use
+      --tiller-namespace string   namespace of tiller (default "kube-system")
+```
+
+### SEE ALSO
+* [helm plugin](helm_plugin.md)	 - add, list, or remove Helm plugins
+
+###### Auto generated by spf13/cobra on 12-Apr-2017

docs/helm/helm_reset.md

@@ -20,6 +20,11 @@ helm reset
 ```
   -f, --force                forces Tiller uninstall even if there are releases installed
       --remove-helm-home     if set deletes $HELM_HOME
+      --tls                  enable TLS for request
+      --tls-ca-cert string   path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
+      --tls-cert string      path to TLS certificate file (default "$HELM_HOME/cert.pem")
+      --tls-key string       path to TLS key file (default "$HELM_HOME/key.pem")
+      --tls-verify           enable TLS for request and verify remote
 ```
 
 ### Options inherited from parent commands
@@ -35,4 +40,4 @@ helm reset
 ### SEE ALSO
 * [helm](helm.md)	 - The Helm package manager for Kubernetes.
 
-###### Auto generated by spf13/cobra on 11-Mar-2017
+###### Auto generated by spf13/cobra on 12-Apr-2017

docs/helm/helm_rollback.md

@@ -24,7 +24,12 @@ helm rollback [flags] [RELEASE] [REVISION]
       --no-hooks             prevent hooks from running during rollback
       --recreate-pods        performs pods restart for the resource if applicable
       --timeout int          time in seconds to wait for any individual kubernetes operation (like Jobs for hooks) (default 300)
-      --wait            if set, will wait until all Pods, PVCs, and Services are in a ready state before marking the release as successful. It will wait for as long as --timeout
+      --tls                  enable TLS for request
+      --tls-ca-cert string   path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
+      --tls-cert string      path to TLS certificate file (default "$HELM_HOME/cert.pem")
+      --tls-key string       path to TLS key file (default "$HELM_HOME/key.pem")
+      --tls-verify           enable TLS for request and verify remote
+      --wait                 if set, will wait until all Pods, PVCs, Services, and minimum number of Pods of a Deployment are in a ready state before marking the release as successful. It will wait for as long as --timeout
 ```
 
 ### Options inherited from parent commands
@@ -40,4 +45,4 @@ helm rollback [flags] [RELEASE] [REVISION]
 ### SEE ALSO
 * [helm](helm.md)	 - The Helm package manager for Kubernetes.
 
-###### Auto generated by spf13/cobra on 11-Mar-2017
+###### Auto generated by spf13/cobra on 12-Apr-2017

docs/helm/helm_status.md

@@ -24,6 +24,11 @@ helm status [flags] RELEASE_NAME
 
 ```
       --revision int32       if set, display the status of the named release with revision
+      --tls                  enable TLS for request
+      --tls-ca-cert string   path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
+      --tls-cert string      path to TLS certificate file (default "$HELM_HOME/cert.pem")
+      --tls-key string       path to TLS key file (default "$HELM_HOME/key.pem")
+      --tls-verify           enable TLS for request and verify remote
 ```
 
 ### Options inherited from parent commands
@@ -39,4 +44,4 @@ helm status [flags] RELEASE_NAME
 ### SEE ALSO
 * [helm](helm.md)	 - The Helm package manager for Kubernetes.
 
-###### Auto generated by spf13/cobra on 11-Mar-2017
+###### Auto generated by spf13/cobra on 12-Apr-2017

docs/helm/helm_upgrade.md

@@ -43,12 +43,18 @@ helm upgrade [RELEASE] [CHART]
       --no-hooks             disable pre/post upgrade hooks
       --recreate-pods        performs pods restart for the resource if applicable
       --reset-values         when upgrading, reset the values to the ones built into the chart
+      --reuse-values         when upgrading, reuse the last release's values, and merge in any new values. If '--reset-values' is specified, this is ignored.
       --set stringArray      set values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
       --timeout int          time in seconds to wait for any individual kubernetes operation (like Jobs for hooks) (default 300)
+      --tls                  enable TLS for request
+      --tls-ca-cert string   path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
+      --tls-cert string      path to TLS certificate file (default "$HELM_HOME/cert.pem")
+      --tls-key string       path to TLS key file (default "$HELM_HOME/key.pem")
+      --tls-verify           enable TLS for request and verify remote
   -f, --values valueFiles    specify values in a YAML file (can specify multiple) (default [])
       --verify               verify the provenance of the chart before upgrading
       --version string       specify the exact chart version to use. If this is not specified, the latest version is used
-      --wait                if set, will wait until all Pods, PVCs, and Services are in a ready state before marking the release as successful. It will wait for as long as --timeout
+      --wait                 if set, will wait until all Pods, PVCs, Services, and minimum number of Pods of a Deployment are in a ready state before marking the release as successful. It will wait for as long as --timeout
 ```
 
 ### Options inherited from parent commands
@@ -64,4 +70,4 @@ helm upgrade [RELEASE] [CHART]
 ### SEE ALSO
 * [helm](helm.md)	 - The Helm package manager for Kubernetes.
 
-###### Auto generated by spf13/cobra on 11-Mar-2017
+###### Auto generated by spf13/cobra on 12-Apr-2017

docs/helm/helm_version.md

@@ -33,6 +33,11 @@ helm version
   -c, --client               client version only
   -s, --server               server version only
       --short                print the version number
+      --tls                  enable TLS for request
+      --tls-ca-cert string   path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
+      --tls-cert string      path to TLS certificate file (default "$HELM_HOME/cert.pem")
+      --tls-key string       path to TLS key file (default "$HELM_HOME/key.pem")
+      --tls-verify           enable TLS for request and verify remote
 ```
 
 ### Options inherited from parent commands
@@ -48,4 +53,4 @@ helm version
 ### SEE ALSO
 * [helm](helm.md)	 - The Helm package manager for Kubernetes.
 
-###### Auto generated by spf13/cobra on 11-Mar-2017
+###### Auto generated by spf13/cobra on 12-Apr-2017

docs/man/man1/helm.1

-.TH "HELM" "1" "Mar 2017" "Auto generated by spf13/cobra" "" 
+.TH "HELM" "1" "Apr 2017" "Auto generated by spf13/cobra" "" 
 .nh
 .ad l
 
@@ -77,9 +77,9 @@ Environment:
 
 .SH SEE ALSO
 .PP
-\fBhelm\-completion(1)\fP, \fBhelm\-create(1)\fP, \fBhelm\-delete(1)\fP, \fBhelm\-dependency(1)\fP, \fBhelm\-fetch(1)\fP, \fBhelm\-get(1)\fP, \fBhelm\-history(1)\fP, \fBhelm\-home(1)\fP, \fBhelm\-init(1)\fP, \fBhelm\-inspect(1)\fP, \fBhelm\-install(1)\fP, \fBhelm\-lint(1)\fP, \fBhelm\-list(1)\fP, \fBhelm\-package(1)\fP, \fBhelm\-repo(1)\fP, \fBhelm\-reset(1)\fP, \fBhelm\-rollback(1)\fP, \fBhelm\-search(1)\fP, \fBhelm\-serve(1)\fP, \fBhelm\-status(1)\fP, \fBhelm\-test(1)\fP, \fBhelm\-upgrade(1)\fP, \fBhelm\-verify(1)\fP, \fBhelm\-version(1)\fP
+\fBhelm\-completion(1)\fP, \fBhelm\-create(1)\fP, \fBhelm\-delete(1)\fP, \fBhelm\-dependency(1)\fP, \fBhelm\-fetch(1)\fP, \fBhelm\-get(1)\fP, \fBhelm\-history(1)\fP, \fBhelm\-home(1)\fP, \fBhelm\-init(1)\fP, \fBhelm\-inspect(1)\fP, \fBhelm\-install(1)\fP, \fBhelm\-lint(1)\fP, \fBhelm\-list(1)\fP, \fBhelm\-package(1)\fP, \fBhelm\-plugin(1)\fP, \fBhelm\-repo(1)\fP, \fBhelm\-reset(1)\fP, \fBhelm\-reset(1)\fP, \fBhelm\-rollback(1)\fP, \fBhelm\-search(1)\fP, \fBhelm\-serve(1)\fP, \fBhelm\-status(1)\fP, \fBhelm\-test(1)\fP, \fBhelm\-test(1)\fP, \fBhelm\-upgrade(1)\fP, \fBhelm\-verify(1)\fP, \fBhelm\-version(1)\fP, \fBhelm\-version(1)\fP
 
 
 .SH HISTORY
 .PP
-11\-Mar\-2017 Auto generated by spf13/cobra
+12\-Apr\-2017 Auto generated by spf13/cobra

docs/man/man1/helm_delete.1

-.TH "HELM" "1" "Mar 2017" "Auto generated by spf13/cobra" "" 
+.TH "HELM" "1" "Apr 2017" "Auto generated by spf13/cobra" "" 
 .nh
 .ad l
 
@@ -40,6 +40,26 @@ deleting them.
 \fB\-\-timeout\fP=300
     time in seconds to wait for any individual kubernetes operation (like Jobs for hooks)
 
+.PP
+\fB\-\-tls\fP[=false]
+    enable TLS for request
+
+.PP
+\fB\-\-tls\-ca\-cert\fP="$HELM\_HOME/ca.pem"
+    path to TLS CA certificate file
+
+.PP
+\fB\-\-tls\-cert\fP="$HELM\_HOME/cert.pem"
+    path to TLS certificate file
+
+.PP
+\fB\-\-tls\-key\fP="$HELM\_HOME/key.pem"
+    path to TLS key file
+
+.PP
+\fB\-\-tls\-verify\fP[=false]
+    enable TLS for request and verify remote
+
 
 .SH OPTIONS INHERITED FROM PARENT COMMANDS
 .PP
@@ -70,4 +90,4 @@ deleting them.
 
 .SH HISTORY
 .PP
-11\-Mar\-2017 Auto generated by spf13/cobra
+12\-Apr\-2017 Auto generated by spf13/cobra

docs/man/man1/helm_dependency.1

-.TH "HELM" "1" "Mar 2017" "Auto generated by spf13/cobra" "" 
+.TH "HELM" "1" "Apr 2017" "Auto generated by spf13/cobra" "" 
 .nh
 .ad l
 
@@ -40,10 +40,10 @@ For example, this requirements file declares two dependencies:
 dependencies:
 \- name: nginx
   version: "1.2.3"
-repository: "https://example.com/charts"
+  repository: "https://example.com/charts"
 \- name: memcached
   version: "3.2.1"
-repository: "https://another.example.com/charts"
+  repository: "https://another.example.com/charts"
 
 .fi
 .RE
@@ -114,4 +114,4 @@ for this case.
 
 .SH HISTORY
 .PP
-11\-Mar\-2017 Auto generated by spf13/cobra
+12\-Apr\-2017 Auto generated by spf13/cobra

docs/man/man1/helm_get.1

-.TH "HELM" "1" "Mar 2017" "Auto generated by spf13/cobra" "" 
+.TH "HELM" "1" "Apr 2017" "Auto generated by spf13/cobra" "" 
 .nh
 .ad l
 
@@ -36,6 +36,26 @@ chart, the supplied values, and the generated manifest file.
 \fB\-\-revision\fP=0
     get the named release with revision
 
+.PP
+\fB\-\-tls\fP[=false]
+    enable TLS for request
+
+.PP
+\fB\-\-tls\-ca\-cert\fP="$HELM\_HOME/ca.pem"
+    path to TLS CA certificate file
+
+.PP
+\fB\-\-tls\-cert\fP="$HELM\_HOME/cert.pem"
+    path to TLS certificate file
+
+.PP
+\fB\-\-tls\-key\fP="$HELM\_HOME/key.pem"
+    path to TLS key file
+
+.PP
+\fB\-\-tls\-verify\fP[=false]
+    enable TLS for request and verify remote
+
 
 .SH OPTIONS INHERITED FROM PARENT COMMANDS
 .PP
@@ -66,4 +86,4 @@ chart, the supplied values, and the generated manifest file.
 
 .SH HISTORY
 .PP
-11\-Mar\-2017 Auto generated by spf13/cobra
+12\-Apr\-2017 Auto generated by spf13/cobra

docs/man/man1/helm_history.1

-.TH "HELM" "1" "Mar 2017" "Auto generated by spf13/cobra" "" 
+.TH "HELM" "1" "Apr 2017" "Auto generated by spf13/cobra" "" 
 .nh
 .ad l
 
@@ -44,6 +44,26 @@ REVISION   UPDATED                      STATUS           CHART        DESCRIPTIO
 \fB\-\-max\fP=256
     maximum number of revision to include in history
 
+.PP
+\fB\-\-tls\fP[=false]
+    enable TLS for request
+
+.PP
+\fB\-\-tls\-ca\-cert\fP="$HELM\_HOME/ca.pem"
+    path to TLS CA certificate file
+
+.PP
+\fB\-\-tls\-cert\fP="$HELM\_HOME/cert.pem"
+    path to TLS certificate file
+
+.PP
+\fB\-\-tls\-key\fP="$HELM\_HOME/key.pem"
+    path to TLS key file
+
+.PP
+\fB\-\-tls\-verify\fP[=false]
+    enable TLS for request and verify remote
+
 
 .SH OPTIONS INHERITED FROM PARENT COMMANDS
 .PP
@@ -74,4 +94,4 @@ REVISION   UPDATED                      STATUS           CHART        DESCRIPTIO
 
 .SH HISTORY
 .PP
-11\-Mar\-2017 Auto generated by spf13/cobra
+12\-Apr\-2017 Auto generated by spf13/cobra

docs/man/man1/helm_init.1

-.TH "HELM" "1" "Mar 2017" "Auto generated by spf13/cobra" "" 
+.TH "HELM" "1" "Apr 2017" "Auto generated by spf13/cobra" "" 
 .nh
 .ad l
 
@@ -52,10 +52,34 @@ To dump a manifest containing the Tiller deployment YAML, combine the
 \fB\-\-dry\-run\fP[=false]
     do not install local or remote
 
+.PP
+\fB\-\-skip\-refresh\fP[=false]
+    do not refresh (download) the local repository cache
+
 .PP
 \fB\-i\fP, \fB\-\-tiller\-image\fP=""
     override tiller image
 
+.PP
+\fB\-\-tiller\-tls\fP[=false]
+    install tiller with TLS enabled
+
+.PP
+\fB\-\-tiller\-tls\-cert\fP=""
+    path to TLS certificate file to install with tiller
+
+.PP
+\fB\-\-tiller\-tls\-key\fP=""
+    path to TLS key file to install with tiller
+
+.PP
+\fB\-\-tiller\-tls\-verify\fP[=false]
+    install tiller with TLS enabled and to verify remote certificates
+
+.PP
+\fB\-\-tls\-ca\-cert\fP=""
+    path to CA root certificate
+
 .PP
 \fB\-\-upgrade\fP[=false]
     upgrade if tiller is already installed
@@ -90,4 +114,4 @@ To dump a manifest containing the Tiller deployment YAML, combine the
 
 .SH HISTORY
 .PP
-11\-Mar\-2017 Auto generated by spf13/cobra
+12\-Apr\-2017 Auto generated by spf13/cobra

docs/man/man1/helm_install.1

-.TH "HELM" "1" "Mar 2017" "Auto generated by spf13/cobra" "" 
+.TH "HELM" "1" "Apr 2017" "Auto generated by spf13/cobra" "" 
 .nh
 .ad l
 
@@ -150,6 +150,26 @@ charts in a repository, use 'helm search'.
 \fB\-\-timeout\fP=300
     time in seconds to wait for any individual kubernetes operation (like Jobs for hooks)
 
+.PP
+\fB\-\-tls\fP[=false]
+    enable TLS for request
+
+.PP
+\fB\-\-tls\-ca\-cert\fP="$HELM\_HOME/ca.pem"
+    path to TLS CA certificate file
+
+.PP
+\fB\-\-tls\-cert\fP="$HELM\_HOME/cert.pem"
+    path to TLS certificate file
+
+.PP
+\fB\-\-tls\-key\fP="$HELM\_HOME/key.pem"
+    path to TLS key file
+
+.PP
+\fB\-\-tls\-verify\fP[=false]
+    enable TLS for request and verify remote
+
 .PP
 \fB\-f\fP, \fB\-\-values\fP=[]
     specify values in a YAML file (can specify multiple)
@@ -164,7 +184,7 @@ charts in a repository, use 'helm search'.
 
 .PP
 \fB\-\-wait\fP[=false]
-    if set, will wait until all Pods, PVCs, and Services are in a ready state before marking the release as successful. It will wait for as long as \-\-timeout
+    if set, will wait until all Pods, PVCs, Services, and minimum number of Pods of a Deployment are in a ready state before marking the release as successful. It will wait for as long as \-\-timeout
 
 
 .SH OPTIONS INHERITED FROM PARENT COMMANDS
@@ -196,4 +216,4 @@ charts in a repository, use 'helm search'.
 
 .SH HISTORY
 .PP
-11\-Mar\-2017 Auto generated by spf13/cobra
+12\-Apr\-2017 Auto generated by spf13/cobra

docs/man/man1/helm_list.1

-.TH "HELM" "1" "Mar 2017" "Auto generated by spf13/cobra" "" 
+.TH "HELM" "1" "Apr 2017" "Auto generated by spf13/cobra" "" 
 .nh
 .ad l
 
@@ -98,6 +98,26 @@ flag with the '\-\-offset' flag allows you to page through results.
 \fB\-q\fP, \fB\-\-short\fP[=false]
     output short (quiet) listing format
 
+.PP
+\fB\-\-tls\fP[=false]
+    enable TLS for request
+
+.PP
+\fB\-\-tls\-ca\-cert\fP="$HELM\_HOME/ca.pem"
+    path to TLS CA certificate file
+
+.PP
+\fB\-\-tls\-cert\fP="$HELM\_HOME/cert.pem"
+    path to TLS certificate file
+
+.PP
+\fB\-\-tls\-key\fP="$HELM\_HOME/key.pem"
+    path to TLS key file
+
+.PP
+\fB\-\-tls\-verify\fP[=false]
+    enable TLS for request and verify remote
+
 
 .SH OPTIONS INHERITED FROM PARENT COMMANDS
 .PP
@@ -128,4 +148,4 @@ flag with the '\-\-offset' flag allows you to page through results.
 
 .SH HISTORY
 .PP
-11\-Mar\-2017 Auto generated by spf13/cobra
+12\-Apr\-2017 Auto generated by spf13/cobra

docs/man/man1/helm_package.1

-.TH "HELM" "1" "Mar 2017" "Auto generated by spf13/cobra" "" 
+.TH "HELM" "1" "Apr 2017" "Auto generated by spf13/cobra" "" 
 .nh
 .ad l
 
@@ -28,6 +28,10 @@ Versioned chart archives are used by Helm package repositories.
 
 
 .SH OPTIONS
+.PP
+\fB\-d\fP, \fB\-\-destination\fP="."
+    location to write the chart.
+
 .PP
 \fB\-\-key\fP=""
     name of the key to use when signing. Used if \-\-sign is true
@@ -78,4 +82,4 @@ Versioned chart archives are used by Helm package repositories.
 
 .SH HISTORY
 .PP
-11\-Mar\-2017 Auto generated by spf13/cobra
+12\-Apr\-2017 Auto generated by spf13/cobra

docs/man/man1/helm_plugin.1

+.TH "HELM" "1" "Apr 2017" "Auto generated by spf13/cobra" "" 
+.nh
+.ad l
+
+
+.SH NAME
+.PP
+helm\-plugin \- add, list, or remove Helm plugins
+
+
+.SH SYNOPSIS
+.PP
+\fBhelm plugin\fP
+
+
+.SH DESCRIPTION
+.PP
+Manage client\-side Helm plugins.
+
+
+.SH OPTIONS INHERITED FROM PARENT COMMANDS
+.PP
+\fB\-\-debug\fP[=false]
+    enable verbose output
+
+.PP
+\fB\-\-home\fP="~/.helm"
+    location of your Helm config. Overrides $HELM\_HOME
+
+.PP
+\fB\-\-host\fP=""
+    address of tiller. Overrides $HELM\_HOST
+
+.PP
+\fB\-\-kube\-context\fP=""
+    name of the kubeconfig context to use
+
+.PP
+\fB\-\-tiller\-namespace\fP="kube\-system"
+    namespace of tiller
+
+
+.SH SEE ALSO
+.PP
+\fBhelm(1)\fP, \fBhelm\-plugin\-install(1)\fP, \fBhelm\-plugin\-list(1)\fP, \fBhelm\-plugin\-remove(1)\fP
+
+
+.SH HISTORY
+.PP
+12\-Apr\-2017 Auto generated by spf13/cobra

docs/man/man1/helm_plugin_install.1

+.TH "HELM" "1" "Apr 2017" "Auto generated by spf13/cobra" "" 
+.nh
+.ad l
+
+
+.SH NAME
+.PP
+helm\-plugin\-install \- install one or more Helm plugins
+
+
+.SH SYNOPSIS
+.PP
+\fBhelm plugin install [options] <path|url>\&...\fP
+
+
+.SH DESCRIPTION
+.PP
+install one or more Helm plugins
+
+
+.SH OPTIONS
+.PP
+\fB\-\-version\fP=""
+    specify a version constraint. If this is not specified, the latest version is installed
+
+
+.SH OPTIONS INHERITED FROM PARENT COMMANDS
+.PP
+\fB\-\-debug\fP[=false]
+    enable verbose output
+
+.PP
+\fB\-\-home\fP="~/.helm"
+    location of your Helm config. Overrides $HELM\_HOME
+
+.PP
+\fB\-\-host\fP=""
+    address of tiller. Overrides $HELM\_HOST
+
+.PP
+\fB\-\-kube\-context\fP=""
+    name of the kubeconfig context to use
+
+.PP
+\fB\-\-tiller\-namespace\fP="kube\-system"
+    namespace of tiller
+
+
+.SH SEE ALSO
+.PP
+\fBhelm\-plugin(1)\fP
+
+
+.SH HISTORY
+.PP
+12\-Apr\-2017 Auto generated by spf13/cobra

docs/man/man1/helm_plugin_list.1

+.TH "HELM" "1" "Apr 2017" "Auto generated by spf13/cobra" "" 
+.nh
+.ad l
+
+
+.SH NAME
+.PP
+helm\-plugin\-list \- list installed Helm plugins
+
+
+.SH SYNOPSIS
+.PP
+\fBhelm plugin list\fP
+
+
+.SH DESCRIPTION
+.PP
+list installed Helm plugins
+
+
+.SH OPTIONS INHERITED FROM PARENT COMMANDS
+.PP
+\fB\-\-debug\fP[=false]
+    enable verbose output
+
+.PP
+\fB\-\-home\fP="~/.helm"
+    location of your Helm config. Overrides $HELM\_HOME
+
+.PP
+\fB\-\-host\fP=""
+    address of tiller. Overrides $HELM\_HOST
+
+.PP
+\fB\-\-kube\-context\fP=""
+    name of the kubeconfig context to use
+
+.PP
+\fB\-\-tiller\-namespace\fP="kube\-system"
+    namespace of tiller
+
+
+.SH SEE ALSO
+.PP
+\fBhelm\-plugin(1)\fP
+
+
+.SH HISTORY
+.PP
+12\-Apr\-2017 Auto generated by spf13/cobra

docs/man/man1/helm_plugin_remove.1

+.TH "HELM" "1" "Apr 2017" "Auto generated by spf13/cobra" "" 
+.nh
+.ad l
+
+
+.SH NAME
+.PP
+helm\-plugin\-remove \- remove one or more Helm plugins
+
+
+.SH SYNOPSIS
+.PP
+\fBhelm plugin remove <plugin>\&...\fP
+
+
+.SH DESCRIPTION
+.PP
+remove one or more Helm plugins
+
+
+.SH OPTIONS INHERITED FROM PARENT COMMANDS
+.PP
+\fB\-\-debug\fP[=false]
+    enable verbose output
+
+.PP
+\fB\-\-home\fP="~/.helm"
+    location of your Helm config. Overrides $HELM\_HOME
+
+.PP
+\fB\-\-host\fP=""
+    address of tiller. Overrides $HELM\_HOST
+
+.PP
+\fB\-\-kube\-context\fP=""
+    name of the kubeconfig context to use
+
+.PP
+\fB\-\-tiller\-namespace\fP="kube\-system"
+    namespace of tiller
+
+
+.SH SEE ALSO
+.PP
+\fBhelm\-plugin(1)\fP
+
+
+.SH HISTORY
+.PP
+12\-Apr\-2017 Auto generated by spf13/cobra

docs/man/man1/helm_reset.1

-.TH "HELM" "1" "Mar 2017" "Auto generated by spf13/cobra" "" 
+.TH "HELM" "1" "Apr 2017" "Auto generated by spf13/cobra" "" 
 .nh
 .ad l
 
@@ -29,6 +29,26 @@ $HELM\_HOME (default \~/.helm/)
 \fB\-\-remove\-helm\-home\fP[=false]
     if set deletes $HELM\_HOME
 
+.PP
+\fB\-\-tls\fP[=false]
+    enable TLS for request
+
+.PP
+\fB\-\-tls\-ca\-cert\fP="$HELM\_HOME/ca.pem"
+    path to TLS CA certificate file
+
+.PP
+\fB\-\-tls\-cert\fP="$HELM\_HOME/cert.pem"
+    path to TLS certificate file
+
+.PP
+\fB\-\-tls\-key\fP="$HELM\_HOME/key.pem"
+    path to TLS key file
+
+.PP
+\fB\-\-tls\-verify\fP[=false]
+    enable TLS for request and verify remote
+
 
 .SH OPTIONS INHERITED FROM PARENT COMMANDS
 .PP
@@ -59,4 +79,4 @@ $HELM\_HOME (default \~/.helm/)
 
 .SH HISTORY
 .PP
-11\-Mar\-2017 Auto generated by spf13/cobra
+12\-Apr\-2017 Auto generated by spf13/cobra

docs/man/man1/helm_rollback.1

-.TH "HELM" "1" "Mar 2017" "Auto generated by spf13/cobra" "" 
+.TH "HELM" "1" "Apr 2017" "Auto generated by spf13/cobra" "" 
 .nh
 .ad l
 
@@ -40,9 +40,29 @@ second is a revision (version) number. To see revision numbers, run
 \fB\-\-timeout\fP=300
     time in seconds to wait for any individual kubernetes operation (like Jobs for hooks)
 
+.PP
+\fB\-\-tls\fP[=false]
+    enable TLS for request
+
+.PP
+\fB\-\-tls\-ca\-cert\fP="$HELM\_HOME/ca.pem"
+    path to TLS CA certificate file
+
+.PP
+\fB\-\-tls\-cert\fP="$HELM\_HOME/cert.pem"
+    path to TLS certificate file
+
+.PP
+\fB\-\-tls\-key\fP="$HELM\_HOME/key.pem"
+    path to TLS key file
+
+.PP
+\fB\-\-tls\-verify\fP[=false]
+    enable TLS for request and verify remote
+
 .PP
 \fB\-\-wait\fP[=false]
-    if set, will wait until all Pods, PVCs, and Services are in a ready state before marking the release as successful. It will wait for as long as \-\-timeout
+    if set, will wait until all Pods, PVCs, Services, and minimum number of Pods of a Deployment are in a ready state before marking the release as successful. It will wait for as long as \-\-timeout
 
 
 .SH OPTIONS INHERITED FROM PARENT COMMANDS
@@ -74,4 +94,4 @@ second is a revision (version) number. To see revision numbers, run
 
 .SH HISTORY
 .PP
-11\-Mar\-2017 Auto generated by spf13/cobra
+12\-Apr\-2017 Auto generated by spf13/cobra

docs/man/man1/helm_status.1

-.TH "HELM" "1" "Mar 2017" "Auto generated by spf13/cobra" "" 
+.TH "HELM" "1" "Apr 2017" "Auto generated by spf13/cobra" "" 
 .nh
 .ad l
 
@@ -30,6 +30,26 @@ The status consists of:
 \fB\-\-revision\fP=0
     if set, display the status of the named release with revision
 
+.PP
+\fB\-\-tls\fP[=false]
+    enable TLS for request
+
+.PP
+\fB\-\-tls\-ca\-cert\fP="$HELM\_HOME/ca.pem"
+    path to TLS CA certificate file
+
+.PP
+\fB\-\-tls\-cert\fP="$HELM\_HOME/cert.pem"
+    path to TLS certificate file
+
+.PP
+\fB\-\-tls\-key\fP="$HELM\_HOME/key.pem"
+    path to TLS key file
+
+.PP
+\fB\-\-tls\-verify\fP[=false]
+    enable TLS for request and verify remote
+
 
 .SH OPTIONS INHERITED FROM PARENT COMMANDS
 .PP
@@ -60,4 +80,4 @@ The status consists of:
 
 .SH HISTORY
 .PP
-11\-Mar\-2017 Auto generated by spf13/cobra
+12\-Apr\-2017 Auto generated by spf13/cobra

docs/man/man1/helm_upgrade.1

-.TH "HELM" "1" "Mar 2017" "Auto generated by spf13/cobra" "" 
+.TH "HELM" "1" "Apr 2017" "Auto generated by spf13/cobra" "" 
 .nh
 .ad l
 
@@ -85,6 +85,10 @@ $ helm upgrade \-\-set foo=bar \-\-set foo=newbar redis ./redis
 \fB\-\-reset\-values\fP[=false]
     when upgrading, reset the values to the ones built into the chart
 
+.PP
+\fB\-\-reuse\-values\fP[=false]
+    when upgrading, reuse the last release's values, and merge in any new values. If '\-\-reset\-values' is specified, this is ignored.
+
 .PP
 \fB\-\-set\fP=[]
     set values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
@@ -93,6 +97,26 @@ $ helm upgrade \-\-set foo=bar \-\-set foo=newbar redis ./redis
 \fB\-\-timeout\fP=300
     time in seconds to wait for any individual kubernetes operation (like Jobs for hooks)
 
+.PP
+\fB\-\-tls\fP[=false]
+    enable TLS for request
+
+.PP
+\fB\-\-tls\-ca\-cert\fP="$HELM\_HOME/ca.pem"
+    path to TLS CA certificate file
+
+.PP
+\fB\-\-tls\-cert\fP="$HELM\_HOME/cert.pem"
+    path to TLS certificate file
+
+.PP
+\fB\-\-tls\-key\fP="$HELM\_HOME/key.pem"
+    path to TLS key file
+
+.PP
+\fB\-\-tls\-verify\fP[=false]
+    enable TLS for request and verify remote
+
 .PP
 \fB\-f\fP, \fB\-\-values\fP=[]
     specify values in a YAML file (can specify multiple)
@@ -107,7 +131,7 @@ $ helm upgrade \-\-set foo=bar \-\-set foo=newbar redis ./redis
 
 .PP
 \fB\-\-wait\fP[=false]
-    if set, will wait until all Pods, PVCs, and Services are in a ready state before marking the release as successful. It will wait for as long as \-\-timeout
+    if set, will wait until all Pods, PVCs, Services, and minimum number of Pods of a Deployment are in a ready state before marking the release as successful. It will wait for as long as \-\-timeout
 
 
 .SH OPTIONS INHERITED FROM PARENT COMMANDS
@@ -139,4 +163,4 @@ $ helm upgrade \-\-set foo=bar \-\-set foo=newbar redis ./redis
 
 .SH HISTORY
 .PP
-11\-Mar\-2017 Auto generated by spf13/cobra
+12\-Apr\-2017 Auto generated by spf13/cobra

docs/man/man1/helm_version.1

-.TH "HELM" "1" "Mar 2017" "Auto generated by spf13/cobra" "" 
+.TH "HELM" "1" "Apr 2017" "Auto generated by spf13/cobra" "" 
 .nh
 .ad l
 
@@ -50,6 +50,26 @@ use '\-\-server'.
 \fB\-\-short\fP[=false]
     print the version number
 
+.PP
+\fB\-\-tls\fP[=false]
+    enable TLS for request
+
+.PP
+\fB\-\-tls\-ca\-cert\fP="$HELM\_HOME/ca.pem"
+    path to TLS CA certificate file
+
+.PP
+\fB\-\-tls\-cert\fP="$HELM\_HOME/cert.pem"
+    path to TLS certificate file
+
+.PP
+\fB\-\-tls\-key\fP="$HELM\_HOME/key.pem"
+    path to TLS key file
+
+.PP
+\fB\-\-tls\-verify\fP[=false]
+    enable TLS for request and verify remote
+
 
 .SH OPTIONS INHERITED FROM PARENT COMMANDS
 .PP
@@ -80,4 +100,4 @@ use '\-\-server'.
 
 .SH HISTORY
 .PP
-11\-Mar\-2017 Auto generated by spf13/cobra
+12\-Apr\-2017 Auto generated by spf13/cobra

scripts/ci.sh

@@ -27,7 +27,7 @@ run_unit_test() {
     echo "Running unit tests with coverage'"
     ./scripts/coverage.sh --coveralls
   else
-    echo "Running unit tests'"
+    echo "Running 'unit tests'"
     make test-unit
   fi
 }
@@ -37,6 +37,11 @@ run_style_check() {
   make test-style
 }
 
+run_docs_check() {
+  echo "Running 'make verify-docs'"
+  make verify-docs
+}
+
 # Build to ensure packages are compiled
 echo "Running 'make build'"
 make build
@@ -44,4 +49,5 @@ make build
 case "${CIRCLE_NODE_INDEX-0}" in
   0) run_unit_test   ;;
   1) run_style_check ;;
+  2) run_docs_check  ;;
 esac

scripts/update-docs.sh

+#!/usr/bin/env bash
+
+# Copyright 2017 The Kubernetes Authors All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+set -euo pipefail
+
+source scripts/util.sh
+
+if LANG=C sed --help 2>&1 | grep -q GNU; then
+  SED="sed"
+elif which gsed &>/dev/null; then
+  SED="gsed"
+else
+  echo "Failed to find GNU sed as sed or gsed. If you are on Mac: brew install gnu-sed." >&2
+  exit 1
+fi
+
+kube::util::ensure-temp-dir
+
+mkdir -p ${KUBE_TEMP}/docs/helm ${KUBE_TEMP}/docs/man/man1 ${KUBE_TEMP}/scripts
+bin/helm docs --dir ${KUBE_TEMP}/docs/helm
+bin/helm docs --dir ${KUBE_TEMP}/docs/man/man1 --type man
+bin/helm docs --dir ${KUBE_TEMP}/scripts --type bash
+
+
+FILES=$(find ${KUBE_TEMP} -type f)
+
+${SED} -i -e "s:${HOME}:~:" ${FILES}
+
+for i in ${FILES}; do
+  ret=0
+  truepath=$(echo ${i} | ${SED} "s:${KUBE_TEMP}/::")
+  diff -NauprB -I 'Auto generated' "${i}" "${truepath}" > /dev/null || ret=$?
+  if [[ $ret -ne 0 ]]; then
+    echo "${truepath} changed. Updating.."
+    cp "${i}" "${truepath}"
+  fi
+done

scripts/util.sh

+#!/usr/bin/env bash
+
+# Copyright 2016 The Kubernetes Authors All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+set -euo pipefail
+
+# Example:  kube::util::trap_add 'echo "in trap DEBUG"' DEBUG
+# See: http://stackoverflow.com/questions/3338030/multiple-bash-traps-for-the-same-signal
+kube::util::trap_add() {
+  local trap_add_cmd
+  trap_add_cmd=$1
+  shift
+
+  for trap_add_name in "$@"; do
+    local existing_cmd
+    local new_cmd
+
+    # Grab the currently defined trap commands for this trap
+    existing_cmd=`trap -p "${trap_add_name}" |  awk -F"'" '{print $2}'`
+
+    if [[ -z "${existing_cmd}" ]]; then
+      new_cmd="${trap_add_cmd}"
+    else
+      new_cmd="${existing_cmd};${trap_add_cmd}"
+    fi
+
+    # Assign the test
+    trap "${new_cmd}" "${trap_add_name}"
+  done
+}
+
+# Opposite of kube::util::ensure-temp-dir()
+kube::util::cleanup-temp-dir() {
+  rm -rf "${KUBE_TEMP}"
+}
+
+# Create a temp dir that'll be deleted at the end of this bash session.
+#
+# Vars set:
+#   KUBE_TEMP
+kube::util::ensure-temp-dir() {
+  if [[ -z ${KUBE_TEMP-} ]]; then
+    KUBE_TEMP=$(mktemp -d 2>/dev/null || mktemp -d -t kubernetes.XXXXXX)
+    kube::util::trap_add kube::util::cleanup-temp-dir EXIT
+  fi
+}

scripts/docs-clean-home.sh → scripts/verify-docs.sh

 #!/usr/bin/env bash
 
-# Copyright 2016 The Kubernetes Authors All rights reserved.
+# Copyright 2017 The Kubernetes Authors All rights reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,6 +16,8 @@
 
 set -euo pipefail
 
+source scripts/util.sh
+
 if LANG=C sed --help 2>&1 | grep -q GNU; then
   SED="sed"
 elif which gsed &>/dev/null; then
@@ -25,6 +27,24 @@ else
   exit 1
 fi
 
-FILES=$(find ./docs -type f)
+kube::util::ensure-temp-dir
+
+mkdir -p ${KUBE_TEMP}/docs/helm ${KUBE_TEMP}/docs/man/man1 ${KUBE_TEMP}/scripts
+bin/helm docs --dir ${KUBE_TEMP}/docs/helm
+bin/helm docs --dir ${KUBE_TEMP}/docs/man/man1 --type man
+bin/helm docs --dir ${KUBE_TEMP}/scripts --type bash
+
+
+FILES=$(find ${KUBE_TEMP} -type f)
 
 ${SED} -i -e "s:${HOME}:~:" ${FILES}
+ret=0
+for i in ${FILES}; do
+  diff -NauprB -I 'Auto generated' ${i} $(echo ${i} | ${SED} "s:${KUBE_TEMP}/::") || ret=$?
+done
+if [[ $ret -eq 0 ]]; then
+  echo "helm docs up to date."
+else
+  echo "helm docs are out of date. Please run \"make docs\""
+  exit 1
+fi