Start docs for updating generated reference pages.

Author: steveperry-53

_data/docs-home.yml

@@ -20,3 +20,7 @@ toc:
   - docs/home/contribute/review-issues.md
   - docs/home/contribute/style-guide.md
   - docs/home/contribute/includes.md
+
+  - title: Updating Automatically Generated Reference Pages
+    section:
+    - docs/home/contribute/generated-reference/kubernetes-components.md

docs/home/contribute/generated-reference/kubernetes-components.md

@@ -0,0 +1,145 @@
+---
+title: Updating Reference Pages for Kubernetes Components
+---
+
+{% capture overview %}
+
+This page shows how to
+
+{% endcapture %}
+
+
+{% capture prerequisites %}
+
+* You need to have
+[Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
+installed.
+
+* You need to have
+[Golang](https://golang.org/doc/install) version 1.8 or later installed,
+and your `$GOPATH` environment variable must be set.
+
+{% endcapture %}
+
+
+{% capture steps %}
+
+## TODO
+
+If you don't already have the Kubernetes source code, get it now:
+
+```shell
+mkdir $GOPATH/src
+cd $GOPATH/src
+go get github.com/kubernetes/kubernetes
+```
+
+Determine the base directory of your clone of the
+[kubernetes/kubernetes](https://github.com/kubernetes/kubernetes) repository.
+For example, if you followed the preceding step to get the Kubernetes source
+code, you base directory is `$GOPATH/src/github.com/kubernetes/kubernetes.`
+The remaining steps refer to your base directory as `<k8s-base>`.
+
+Run the doc generation script:
+
+```shell
+cd <k8s-base>
+hack/generate-docs.sh
+```
+
+The script calls these Golang programs to generate several sets of reference docs:
+
+* [gen_kubectl_docs.go](https://github.com/kubernetes/kubernetes/blob/master/cmd/gendocs/gen_kubectl_docs.go)
+* [gen_kube_docs.go](https://github.com/kubernetes/kubernetes/blob/master/cmd/genkubedocs/gen_kube_docs.go)
+* [gen_kube_man.go](https://github.com/kubernetes/kubernetes/blob/master/cmd/genman/gen_kube_man.go)
+* [gen_kubectl_yaml.go](https://github.com/kubernetes/kubernetes/blob/master/cmd/genyaml/gen_kubectl_yaml.go)
+
+###  gen_kubectl_docs.go
+
+The code at `<k8s-base>/cmd/gendocs/gen_kubectl_docs.go` generates reference
+pages for the `kubectl` commands. It places Markdown files in
+`<k8s-base>`/docs/user-guide/kubectl`.
+
+* kubectl_create.md
+* kubectl_apply.md
+* kubectl_describe.md
+* ... (many more)
+
+These files are not published at
+[kubernetes.io](/docs/home).
+Instead, the `kubectl` commands are published as
+[one large page](https://kubernetes.io/docs/user-guide/kubectl/{{page.version}}/)
+that is generated by code at
+[kubernetes-incubator/reference-docs/gen-kubectldocs](https://github.com/kubernetes-incubator/reference-docs/tree/master/gen-kubectldocs).
+
+**Note** This set of files contains documents for the `kubectl` commands, like
+`kubectl create`, but it does not include a document for the
+[kubectl options page](https://kubernetes.io/docs/user-guide/kubectl/).
+{: note}
+
+### gen_kube_docs.go
+
+The code at `<k8s-base>/cmd/genkubedocs/gen_kube_docs.go` generates reference
+pages for several Kubernetes components. It places Markdown files in `<k8s-base>/docs/admin>`.
+
+* cloud-controller-manager.md
+* kube-apiserver.md
+* kube-controller-manager.md
+* kubelet.md
+* kube-proxy.md
+* kube-scheduler.md
+* kubeadm.md
+* kubeadm_xxx.md (many)
+
+These files are published at
+[kubernetes.io/docs/reference](/docs/reference/).
+Example: [kube-api-server](/docs/reference/generated/kube-apiserver/).
+
+The `kubeadm_xxx.md` files are not published directly. Instead, they
+are included in manually created topics like
+[kubeadm join]().
+
+### gen_kube_man.go
+
+The code at `<k8s-base>/cmd/genman/gen_kube_man.go generates reference
+pages for Kubernetes components, `kubectl` commands, and `kubadm`. It places
+man pages in `<k8s-base>/docs/man/man1`.
+
+* cloud-controller-manager.1
+* kube-apiserver.1
+* kube-controller-manager.1
+* kubelet.1
+* kube-proxy.1
+* kube-scheduler.1
+* kubeadm.1
+* kubeadm-xxx.1 (many)
+* kubectl-xxx.1 (many)
+
+These files are published at [manpages.org](http://manpages.org).
+Example: [kube-controller-manager](http://manpages.org/kube-controller-manager).
+
+The `kubeadm-xxx.1` files are not published directly.
+
+Some of these files are also published at [rpm.phone.net](http://rpm.phone.net).
+Example: [kubectl-create](http://rpm.pbone.net/index.php3/stat/45/idpl/30415699/numer/1/nazwa/kubectl-create).
+
+### gen_kubectl_yaml
+
+The code at `<k8s-base>/cmd/genyaml/gen_kubectl_yaml` generates reference
+pages for the `kubectl` commands. It places YAML files in `<k8s-base>/docs/yaml/kubectl`.
+
+    * kubectl_create.yaml
+    * kubectl_apply.yaml
+    * kubectl_describe.yaml
+    * ... (many more)
+
+{% endcapture %}
+
+{% capture whatsnext %}
+
+Generating the kubectl reference docs
+
+{% endcapture %}
+
+
+{% include templates/task.md %}