Docs: Update user guide list to include Windows, update description of clusters

README.md

@@ -17,15 +17,19 @@ The cluster definition file enables you to customize your Docker enabled cluster
 * Custom VNET
 * Extensions
 
+More info, including a thorough walkthrough is [here](docs/acsengine.md).
+
 ## User guides
 
-* [ACS Engine](docs/acsengine.md) - shows you how to build and use the ACS engine to generate custom Docker enabled container clusters
+These guides show how to create your first deployment for each orchestrator:
+* [DC/OS Walkthrough](docs/dcos.md) - shows how to create a DC/OS cluster on Azure
+* [Kubernetes Walkthrough](docs/kubernetes.md) - shows how to create a Linux or Windows Kubernetes cluster on Azure
+* [OpenShift Walkthrough](docs/openshift.md) - shows how to create an OpenShift cluster on Azure
+* [Swarm Mode Walkthrough](docs/swarmmode.md) - shows how to create a [Docker Swarm Mode](https://docs.docker.com/engine/swarm/) cluster on Azure
+* [Standalone Swarm Walkthrough](docs/swarm.md) - shows how to create a [Docker Standalone Swarm](https://docs.docker.com/swarm/) cluster on Azure
+
+These guides cover more advanced features to try out after you have built your first cluster:
 * [Cluster Definition](docs/clusterdefinition.md) - describes the components of the cluster definition file
-* [DC/OS Walkthrough](docs/dcos.md) - shows how to create a DC/OS enabled Docker cluster on Azure
-* [Kubernetes Walkthrough](docs/kubernetes.md) - shows how to create a Kubernetes enabled Docker cluster on Azure
-* [OpenShift Walkthrough](docs/openshift.md) - shows how to create an OpenShift enabled Docker cluster on Azure
-* [Swarm Walkthrough](docs/swarm.md) - shows how to create a Swarm enabled Docker cluster on Azure
-* [Swarm Mode Walkthrough](docs/swarmmode.md) - shows how to create a Swarm Mode cluster on Azure
 * [Custom VNET](examples/vnet) - shows how to use a custom VNET
 * [Attached Disks](examples/disks-storageaccount) - shows how to attach up to 4 disks per node
 * [Managed Disks](examples/disks-managed) - shows how to use managed disks

docs/kubernetes.md

@@ -1,8 +1,9 @@
 # Microsoft Azure Container Service Engine - Kubernetes
 
-* [Create a Kubernetes Cluster](kubernetes/deploy.md) - Create your first Kubernetes cluster. Start here!
+* Create a Kubernetes Cluster
+  * [Linux](kubernetes/deploy.md) - Create your first Linux Kubernetes cluster
+  * [Windows](kubernetes/windows.md) - Create your first Windows Kubernetes cluster
 * [Kubernetes Next Steps](kubernetes/walkthrough.md) - You have successfully deployed a Kubernetes cluster, now what?
-
 * [Troubleshooting](kubernetes/troubleshooting.md) - Running into issues? Start here to troubleshoot Kubernetes.
 * [Features](kubernetes/features.md) - Guide to alpha, beta, and stable functionality in acs-engine.
 * [For Kubernetes Developers](kubernetes/k8s-developers.md) - Info for devs working on Kubernetes upstream and wanting to test using acs-engine.