move user docs to their new home

docs/user-guide/simple-yaml.md

@@ -0,0 +1,100 @@
+<!-- BEGIN MUNGE: UNVERSIONED_WARNING -->
+
+<!-- BEGIN STRIP_FOR_RELEASE -->
+
+<h1>*** PLEASE NOTE: This document applies to the HEAD of the source
+tree only. If you are using a released version of Kubernetes, you almost
+certainly want the docs that go with that version.</h1>
+
+<strong>Documentation for specific releases can be found at
+[releases.k8s.io](http://releases.k8s.io).</strong>
+
+<!-- END STRIP_FOR_RELEASE -->
+
+<!-- END MUNGE: UNVERSIONED_WARNING -->
+## Getting started with config files.
+
+In addition to the imperative style commands described [elsewhere](simple-nginx.md), Kubernetes
+supports declarative YAML or JSON configuration files.  Often times config files are preferable
+to imperative commands, since they can be checked into version control and changes to the files
+can be code reviewed, producing a more robust, reliable and archival system.
+
+### Running a container from a pod configuration file
+
+```bash
+cd kubernetes
+kubectl create -f pod.yaml
+```
+
+Where pod.yaml contains something like:
+
+```yaml
+apiVersion: v1
+kind: Pod
+metadata:
+  name: nginx
+  labels:
+    app: nginx
+spec:
+  containers:
+  - name: nginx
+    image: nginx
+    ports:
+    - containerPort: 80
+```
+
+You can see your cluster's pods:
+
+```bash
+kubectl get pods
+```
+
+and delete the pod you just created:
+
+```bash
+kubectl delete pods nginx
+```
+
+### Running a replicated set of containers from a configuration file
+To run replicated containers, you need a [Replication Controller](../docs/replication-controller.md).
+A replication controller is responsible for ensuring that a specific number of pods exist in the
+cluster.
+
+```bash
+cd kubernetes
+kubectl create -f replication.yaml
+```
+
+Where ```replication.yaml``` contains:
+
+```yaml
+apiVersion: v1
+kind: ReplicationController
+metadata:
+  name: nginx
+spec:
+  replicas: 3
+  selector:
+    app: nginx
+  template:
+    metadata:
+      name: nginx
+      labels:
+        app: nginx
+    spec:
+      containers:
+      - name: nginx
+        image: nginx
+        ports:
+        - containerPort: 80
+```
+
+To delete the replication controller (and the pods it created):
+```bash
+kubectl delete rc nginx
+```
+
+
+<!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
+[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/examples/simple-yaml.md?pixel)]()
+<!-- END MUNGE: GENERATED_ANALYTICS -->