Revamped Reference section with proper landing page

_data/reference.yml

@@ -20,6 +20,24 @@ toc:
   - title: Extensions API Definitions
     path: /docs/api-reference/extensions/v1beta1/definitions/
 
+- title: kube-apiserver
+  section:
+  - title: Overview
+    path: /docs/admin/kube-apiserver/
+  - title: Authorization Plugins
+    path: /docs/admin/authorization/
+  - title: Authentication
+    path: /docs/admin/authentication/
+  - title: Accessing the API
+    path: /docs/admin/accessing-the-api/
+  - title: Admission Controllers
+    path: /docs/admin/admission-controllers/
+  - title: Managing Service Accounts
+    path: /docs/admin/service-accounts-admin/
+
+- title: etcd
+  path: /docs/admin/etcd/
+
 - title: kubectl
   section:
   - title: kubectl Overview
@@ -95,37 +113,19 @@ toc:
     - title: kubectl version
       path: /docs/user-guide/kubectl/kubectl_version/
 
-- title: kube-apiserver
+- title: JSONpath
-  section:
+  path: /docs/user-guide/jsonpath/
-  - title: Overview
+
-    path: /docs/admin/kube-apiserver/
+- title: kube-proxy
-  - title: Authorization Plugins
+  path: /docs/admin/kube-proxy/
-    path: /docs/admin/authorization/
-  - title: Authentication
-    path: /docs/admin/authentication/
-  - title: Accessing the API
-    path: /docs/admin/accessing-the-api/
-  - title: Admission Controllers
-    path: /docs/admin/admission-controllers/
-  - title: Managing Service Accounts
-    path: /docs/admin/service-accounts-admin/
 
 - title: kub-scheduler
   path: /docs/admin/kube-scheduler/
 
 - title: kubelet
-  path: /docs/admin/kubelet.md
+  path: /docs/admin/kubelet/
 
-- title: kube-proxy
+- title: Glossary
-  path: /docs/admin/kube-proxy/
-
-- title: JSONpath
-  path: /docs/user-guide/jsonpath/
-
-- title: etcd
-  path: /docs/admin/etcd/
-
-- title: Concept Definitions
   section:
   - title: Container Environment
     path: /docs/user-guide/container-environment/

docs/reference.md

@@ -1,3 +1,27 @@
 ---
 ---
-This is the landing page for the reference section.
+In the reference section, you can find reference documentation for Kubernetes APIs, CLIs, and tools, as well as our glossary and design docs. 
+
+## API References
+
+* [Kubernetes API](/docs/api/) - The core API for Kubernetes.
+* [Extensions API](/docs/api-reference/extensions/v1beta1/operations/) - Manages extensions resources such as Jobs, Ingress and HorizontalPodAutoscalers.
+* [kube-apiserver](/docs/admin/kube-apiserver/) - REST API that validates and configures data for API objects such as  pods, services, replication controllers.
+* [etcd](/docs/admin/etcd/) -  Highly-available key value store which Kubernetes uses for persistent storage of all of its REST API objects.
+
+
+## CLI References
+
+* [kubectl](/docs/user-guide/kubectl-overview/) - Runs commands against Kubernetes clusters.
+	* [JSONPath](/docs/user-guide/jsonpath/) - Syntax guide for using [JSONPath expressions](http://goessner.net/articles/JsonPath/) with kubectl.
+* [kube-proxy](/docs/admin/kube-proxy/) - Can do simple TCP/UDP stream forwarding or round-robin TCP/UDP forwarding across a set of backends.
+* [kube-scheduler](/docs/admin/kube-scheduler/) - A policy-rich, topology-aware, workload-specific function that significantly impacts availability, performance, and capacity.
+* [kubelet](/docs/admin/kubelet/) - The primary "node agent" that runs on each node. The kubelet takes a set of PodSpecs and ensures that the described containers are running and healthy.
+
+## Glossary
+
+Explore the glossary of essential Kubernetes concepts. Some good starting points are the entries for [Pods](/docs/user-guide/pods/), [Nodes](/docs/user-guide/pods/), [Services](/docs/user-guide/services/), and [Replication Controllers](/docs/user-guide/replication-controller/).
+
+## Design Docs
+
+An archive of the design docs for Kubernetes functionality. Good starting points are [Kubernetes Architecture](https://github.com/kubernetes/kubernetes/blob/release-1.1/docs/design/architecture.md) and [Kubernetes Design Overview](https://github.com/kubernetes/kubernetes/tree/release-1.1/docs/design).