add processing of kubectl cmd links (#16529)

- add processing of kubectl links in update-imported-docs.
- update component reference generation guide.
- For more information, see issue #16454.

content/en/docs/contribute/generate-ref-docs/kubernetes-components.md

@@ -7,8 +7,7 @@ content_template: templates/task
 
 This page shows how to use the `update-imported-docs` tool to generate
 reference documentation for tools and components in the
-[Kubernetes](https://github.com/kubernetes/kubernetes) and
-[Federation](https://github.com/kubernetes/federation) repositories.
+[Kubernetes](https://github.com/kubernetes/kubernetes) repository.
 
 {{% /capture %}}
 
@@ -66,7 +65,7 @@ The remaining steps refer to your base directory as `<k8s-base>`.
 
 The reference documentation for the Kubernetes components and tools is automatically
 generated from the Kubernetes source code. If you want to change the reference documentation,
-please follow [this guide](/docs/contribute/gen-ref-docs/contribute-upstream).
+please follow [this guide](/docs/contribute/generate-ref-docs/contribute-upstream).
 
 {{< note >}}
 If you only need to generate, but not change, the reference docs, you don't need to
@@ -80,12 +79,13 @@ The `update-imported-docs` tool is located in the `kubernetes/website/update-imp
 directory. The tool performs the following steps:
 
 1. Clones the related repositories specified in a configuration file. For the
-   purpose of generating reference docs, the repositories that are cloned by
-   default are `kubernetes-incubator/reference-docs` and `kubernetes/federation`.
+   purpose of generating reference docs, the repository that is cloned by
+   default is `kubernetes-incubator/reference-docs`.
 1. Runs commands under the cloned repositories to prepare the docs generator and
    then generates the Markdown files.
 1. Copies the generated Markdown files to a local clone of the `kubernetes/website`
    repository under locations specified in the configuration file.
+1. Updates `kubectl` command links from `kubectl`.md to the `kubectl` command reference.
 
 When the Markdown files are in your local clone of the `kubernetes/website`
 repository, you can submit them in a [pull request](/docs/contribute/start/)
@@ -171,12 +171,12 @@ might look like this:
 ...
 
     modified:   content/en/docs/reference/command-line-tools-reference/cloud-controller-manager.md
-    modified:   content/en/docs/reference/command-line-tools-reference/federation-apiserver.md
-    modified:   content/en/docs/reference/command-line-tools-reference/federation-controller-manager.md
     modified:   content/en/docs/reference/command-line-tools-reference/kube-apiserver.md
     modified:   content/en/docs/reference/command-line-tools-reference/kube-controller-manager.md
     modified:   content/en/docs/reference/command-line-tools-reference/kube-proxy.md
     modified:   content/en/docs/reference/command-line-tools-reference/kube-scheduler.md
+    modified:   content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm.md
+    modified:   content/en/docs/reference/kubectl/kubectl.md
 ...
 ```
 
@@ -196,8 +196,7 @@ topics will be visible in the
 
 {{% capture whatsnext %}}
 
-* [Generating Reference Documentation for kubectl Commands](/docs/home/contribute/generated-reference/kubectl/)
-* [Generating Reference Documentation for the Kubernetes API](/docs/home/contribute/generated-reference/kubernetes-api/)
-* [Generating Reference Documentation for the Kubernetes Federation API](/docs/home/contribute/generated-reference/federation-api/)
-* [Contributing to the Upstream Kubernetes Project for Documentation](/docs/contribute/gen-ref-docs/contribute-upstream)
+* [Generating Reference Documentation for kubectl Commands](/docs/contribute/generate-ref-docs/kubectl/)
+* [Generating Reference Documentation for the Kubernetes API](/docs/contribute/generate-ref-docs/kubernetes-api/)
+* [Contributing to the Upstream Kubernetes Project for Documentation](/docs/contribute/generate-ref-docs/contribute-upstream/)
 {{% /capture %}}