Merge pull request #9353 from erictune/docs10

docs/accessing_the_api.md

-# Reaching the API
+# Configuring APIserver ports
+
+This document describes what ports the kubernetes apiserver
+may serve on and how to reach them.  The audience is
+cluster administrators who want to customize their cluster
+or understand the details. 
+
+Most questions about accessing the cluster are covered
+in [Accessing the cluster](../docs/accessing-the-cluster.md).
+
 
 ## Ports and IPs Served On
 The Kubernetes API is served by the Kubernetes APIServer process.  Typically,

docs/services.md

@@ -293,7 +293,7 @@ they desire, but leaves them freedom to do discovery in their own way.
 Applications can still use a self-registration pattern and adapters for other
 discovery systems could easily be built upon this API.
 
-## External services
+##<a name="external"></a>External services
 
 For some parts of your application (e.g. frontends) you may want to expose a
 Service onto an external (outside of your cluster, maybe public internet) IP

docs/user-guide.md

@@ -38,12 +38,11 @@ kubernetes API, or to contribute directly to the kubernetes project.
   (e.g. ssh keys, passwords) separately from the Pods that use them, protecting
   the sensitive data from proliferation by tools that process pods.
 
+* **Accessing the API and other cluster services via a Proxy** [accessing-the-cluster.md](../docs/accessing-the-cluster.md)
+
 * **API Overview** ([api.md](api.md)): Pointers to API documentation on various topics
   and explanation of Kubernetes's approaches to API changes and API versioning.
 
-* **Accessing the API** ([accessing_the_api.md](accessing_the_api.md)):
-  Ports, IPs, proxies, and firewall rules.
-
 * **Kubernetes Web Interface** ([ui.md](ui.md)): Accessing the Kubernetes
   web user interface.
 
@@ -88,8 +87,6 @@ kubernetes API, or to contribute directly to the kubernetes project.
   Provides resource information such as size, type, and quantity to assist in
   assigning Kubernetes resources appropriately.
 
-* **Accessing cluster services via a Proxy** [accessing-the-cluster.md](../docs/accessing-the-cluster.md)
-
 * The [API object documentation](http://kubernetes.io/third_party/swagger-ui/).
 
 * Frequently asked questions are answered on this project's [wiki](https://github.com/GoogleCloudPlatform/kubernetes/wiki).