diff --git a/docs/accessing-the-cluster.md b/docs/user-guide/accessing-the-cluster.md
similarity index 100%
rename from docs/accessing-the-cluster.md
rename to docs/user-guide/accessing-the-cluster.md
diff --git a/docs/annotations.md b/docs/user-guide/annotations.md
similarity index 100%
rename from docs/annotations.md
rename to docs/user-guide/annotations.md
diff --git a/docs/application-troubleshooting.md b/docs/user-guide/application-troubleshooting.md
similarity index 100%
rename from docs/application-troubleshooting.md
rename to docs/user-guide/application-troubleshooting.md
diff --git a/docs/compute-resources.md b/docs/user-guide/compute-resources.md
similarity index 100%
rename from docs/compute-resources.md
rename to docs/user-guide/compute-resources.md
diff --git a/docs/container-environment.md b/docs/user-guide/container-environment.md
similarity index 100%
rename from docs/container-environment.md
rename to docs/user-guide/container-environment.md
diff --git a/docs/containers.md b/docs/user-guide/containers.md
similarity index 100%
rename from docs/containers.md
rename to docs/user-guide/containers.md
diff --git a/docs/debugging-services.md b/docs/user-guide/debugging-services.md
similarity index 100%
rename from docs/debugging-services.md
rename to docs/user-guide/debugging-services.md
diff --git a/docs/downward-api.md b/docs/user-guide/downward-api.md
similarity index 100%
rename from docs/downward-api.md
rename to docs/user-guide/downward-api.md
diff --git a/examples/downward-api/README.md b/docs/user-guide/downward-api/README.md
similarity index 100%
rename from examples/downward-api/README.md
rename to docs/user-guide/downward-api/README.md
diff --git a/examples/downward-api/dapi-pod.yaml b/docs/user-guide/downward-api/dapi-pod.yaml
similarity index 100%
rename from examples/downward-api/dapi-pod.yaml
rename to docs/user-guide/downward-api/dapi-pod.yaml
diff --git a/examples/environment-guide/README.md b/docs/user-guide/environment-guide/README.md
similarity index 100%
rename from examples/environment-guide/README.md
rename to docs/user-guide/environment-guide/README.md
diff --git a/examples/environment-guide/backend-rc.yaml b/docs/user-guide/environment-guide/backend-rc.yaml
similarity index 100%
rename from examples/environment-guide/backend-rc.yaml
rename to docs/user-guide/environment-guide/backend-rc.yaml
diff --git a/examples/environment-guide/backend-srv.yaml b/docs/user-guide/environment-guide/backend-srv.yaml
similarity index 100%
rename from examples/environment-guide/backend-srv.yaml
rename to docs/user-guide/environment-guide/backend-srv.yaml
diff --git a/examples/environment-guide/containers/README.md b/docs/user-guide/environment-guide/containers/README.md
similarity index 100%
rename from examples/environment-guide/containers/README.md
rename to docs/user-guide/environment-guide/containers/README.md
diff --git a/examples/environment-guide/containers/backend/Dockerfile b/docs/user-guide/environment-guide/containers/backend/Dockerfile
similarity index 100%
rename from examples/environment-guide/containers/backend/Dockerfile
rename to docs/user-guide/environment-guide/containers/backend/Dockerfile
diff --git a/examples/environment-guide/containers/backend/backend.go b/docs/user-guide/environment-guide/containers/backend/backend.go
similarity index 100%
rename from examples/environment-guide/containers/backend/backend.go
rename to docs/user-guide/environment-guide/containers/backend/backend.go
diff --git a/examples/environment-guide/containers/show/Dockerfile b/docs/user-guide/environment-guide/containers/show/Dockerfile
similarity index 100%
rename from examples/environment-guide/containers/show/Dockerfile
rename to docs/user-guide/environment-guide/containers/show/Dockerfile
diff --git a/examples/environment-guide/containers/show/show.go b/docs/user-guide/environment-guide/containers/show/show.go
similarity index 100%
rename from examples/environment-guide/containers/show/show.go
rename to docs/user-guide/environment-guide/containers/show/show.go
diff --git a/examples/environment-guide/diagram.png b/docs/user-guide/environment-guide/diagram.png
similarity index 100%
rename from examples/environment-guide/diagram.png
rename to docs/user-guide/environment-guide/diagram.png
diff --git a/examples/environment-guide/show-rc.yaml b/docs/user-guide/environment-guide/show-rc.yaml
similarity index 100%
rename from examples/environment-guide/show-rc.yaml
rename to docs/user-guide/environment-guide/show-rc.yaml
diff --git a/examples/environment-guide/show-srv.yaml b/docs/user-guide/environment-guide/show-srv.yaml
similarity index 100%
rename from examples/environment-guide/show-srv.yaml
rename to docs/user-guide/environment-guide/show-srv.yaml
diff --git a/docs/identifiers.md b/docs/user-guide/identifiers.md
similarity index 100%
rename from docs/identifiers.md
rename to docs/user-guide/identifiers.md
diff --git a/docs/images.md b/docs/user-guide/images.md
similarity index 100%
rename from docs/images.md
rename to docs/user-guide/images.md
diff --git a/docs/influx.png b/docs/user-guide/influx.png
similarity index 100%
rename from docs/influx.png
rename to docs/user-guide/influx.png
diff --git a/docs/k8s-ui-explore-filter.png b/docs/user-guide/k8s-ui-explore-filter.png
similarity index 100%
rename from docs/k8s-ui-explore-filter.png
rename to docs/user-guide/k8s-ui-explore-filter.png
diff --git a/docs/k8s-ui-explore-groupby.png b/docs/user-guide/k8s-ui-explore-groupby.png
similarity index 100%
rename from docs/k8s-ui-explore-groupby.png
rename to docs/user-guide/k8s-ui-explore-groupby.png
diff --git a/docs/k8s-ui-explore-poddetail.png b/docs/user-guide/k8s-ui-explore-poddetail.png
similarity index 100%
rename from docs/k8s-ui-explore-poddetail.png
rename to docs/user-guide/k8s-ui-explore-poddetail.png
diff --git a/docs/k8s-ui-explore.png b/docs/user-guide/k8s-ui-explore.png
similarity index 100%
rename from docs/k8s-ui-explore.png
rename to docs/user-guide/k8s-ui-explore.png
diff --git a/docs/k8s-ui-nodes.png b/docs/user-guide/k8s-ui-nodes.png
similarity index 100%
rename from docs/k8s-ui-nodes.png
rename to docs/user-guide/k8s-ui-nodes.png
diff --git a/docs/k8s-ui-overview.png b/docs/user-guide/k8s-ui-overview.png
similarity index 100%
rename from docs/k8s-ui-overview.png
rename to docs/user-guide/k8s-ui-overview.png
diff --git a/docs/kibana.png b/docs/user-guide/kibana.png
similarity index 100%
rename from docs/kibana.png
rename to docs/user-guide/kibana.png
diff --git a/docs/kubeconfig-file.md b/docs/user-guide/kubeconfig-file.md
similarity index 100%
rename from docs/kubeconfig-file.md
rename to docs/user-guide/kubeconfig-file.md
diff --git a/docs/labels.md b/docs/user-guide/labels.md
similarity index 100%
rename from docs/labels.md
rename to docs/user-guide/labels.md
diff --git a/examples/limitrange/README.md b/docs/user-guide/limitrange/README.md
similarity index 100%
rename from examples/limitrange/README.md
rename to docs/user-guide/limitrange/README.md
diff --git a/examples/limitrange/invalid-pod.yaml b/docs/user-guide/limitrange/invalid-pod.yaml
similarity index 100%
rename from examples/limitrange/invalid-pod.yaml
rename to docs/user-guide/limitrange/invalid-pod.yaml
diff --git a/examples/limitrange/limits.yaml b/docs/user-guide/limitrange/limits.yaml
similarity index 100%
rename from examples/limitrange/limits.yaml
rename to docs/user-guide/limitrange/limits.yaml
diff --git a/examples/limitrange/namespace.yaml b/docs/user-guide/limitrange/namespace.yaml
similarity index 100%
rename from examples/limitrange/namespace.yaml
rename to docs/user-guide/limitrange/namespace.yaml
diff --git a/examples/limitrange/valid-pod.yaml b/docs/user-guide/limitrange/valid-pod.yaml
similarity index 100%
rename from examples/limitrange/valid-pod.yaml
rename to docs/user-guide/limitrange/valid-pod.yaml
diff --git a/examples/liveness/README.md b/docs/user-guide/liveness/README.md
similarity index 100%
rename from examples/liveness/README.md
rename to docs/user-guide/liveness/README.md
diff --git a/examples/liveness/exec-liveness.yaml b/docs/user-guide/liveness/exec-liveness.yaml
similarity index 100%
rename from examples/liveness/exec-liveness.yaml
rename to docs/user-guide/liveness/exec-liveness.yaml
diff --git a/examples/liveness/http-liveness.yaml b/docs/user-guide/liveness/http-liveness.yaml
similarity index 100%
rename from examples/liveness/http-liveness.yaml
rename to docs/user-guide/liveness/http-liveness.yaml
diff --git a/examples/liveness/image/Dockerfile b/docs/user-guide/liveness/image/Dockerfile
similarity index 100%
rename from examples/liveness/image/Dockerfile
rename to docs/user-guide/liveness/image/Dockerfile
diff --git a/examples/liveness/image/Makefile b/docs/user-guide/liveness/image/Makefile
similarity index 100%
rename from examples/liveness/image/Makefile
rename to docs/user-guide/liveness/image/Makefile
diff --git a/examples/liveness/image/server.go b/docs/user-guide/liveness/image/server.go
similarity index 100%
rename from examples/liveness/image/server.go
rename to docs/user-guide/liveness/image/server.go
diff --git a/examples/logging-demo/Makefile b/docs/user-guide/logging-demo/Makefile
similarity index 100%
rename from examples/logging-demo/Makefile
rename to docs/user-guide/logging-demo/Makefile
diff --git a/examples/logging-demo/README.md b/docs/user-guide/logging-demo/README.md
similarity index 100%
rename from examples/logging-demo/README.md
rename to docs/user-guide/logging-demo/README.md
diff --git a/examples/logging-demo/synth-logger.png b/docs/user-guide/logging-demo/synth-logger.png
similarity index 100%
rename from examples/logging-demo/synth-logger.png
rename to docs/user-guide/logging-demo/synth-logger.png
diff --git a/examples/logging-demo/synthetic_0_25lps.yaml b/docs/user-guide/logging-demo/synthetic_0_25lps.yaml
similarity index 100%
rename from examples/logging-demo/synthetic_0_25lps.yaml
rename to docs/user-guide/logging-demo/synthetic_0_25lps.yaml
diff --git a/examples/logging-demo/synthetic_10lps.yaml b/docs/user-guide/logging-demo/synthetic_10lps.yaml
similarity index 100%
rename from examples/logging-demo/synthetic_10lps.yaml
rename to docs/user-guide/logging-demo/synthetic_10lps.yaml
diff --git a/docs/logging.md b/docs/user-guide/logging.md
similarity index 100%
rename from docs/logging.md
rename to docs/user-guide/logging.md
diff --git a/docs/monitoring-architecture.png b/docs/user-guide/monitoring-architecture.png
similarity index 100%
rename from docs/monitoring-architecture.png
rename to docs/user-guide/monitoring-architecture.png
diff --git a/docs/monitoring.md b/docs/user-guide/monitoring.md
similarity index 100%
rename from docs/monitoring.md
rename to docs/user-guide/monitoring.md
diff --git a/examples/multi-pod.yaml b/docs/user-guide/multi-pod.yaml
similarity index 100%
rename from examples/multi-pod.yaml
rename to docs/user-guide/multi-pod.yaml
diff --git a/docs/namespaces.md b/docs/user-guide/namespaces.md
similarity index 100%
rename from docs/namespaces.md
rename to docs/user-guide/namespaces.md
diff --git a/examples/node-selection/README.md b/docs/user-guide/node-selection/README.md
similarity index 100%
rename from examples/node-selection/README.md
rename to docs/user-guide/node-selection/README.md
diff --git a/examples/node-selection/pod.yaml b/docs/user-guide/node-selection/pod.yaml
similarity index 100%
rename from examples/node-selection/pod.yaml
rename to docs/user-guide/node-selection/pod.yaml
diff --git a/docs/overview.md b/docs/user-guide/overview.md
similarity index 100%
rename from docs/overview.md
rename to docs/user-guide/overview.md
diff --git a/docs/persistent-volumes.md b/docs/user-guide/persistent-volumes.md
similarity index 100%
rename from docs/persistent-volumes.md
rename to docs/user-guide/persistent-volumes.md
diff --git a/examples/persistent-volumes/README.md b/docs/user-guide/persistent-volumes/README.md
similarity index 100%
rename from examples/persistent-volumes/README.md
rename to docs/user-guide/persistent-volumes/README.md
diff --git a/examples/persistent-volumes/claims/claim-01.yaml b/docs/user-guide/persistent-volumes/claims/claim-01.yaml
similarity index 100%
rename from examples/persistent-volumes/claims/claim-01.yaml
rename to docs/user-guide/persistent-volumes/claims/claim-01.yaml
diff --git a/examples/persistent-volumes/claims/claim-02.yaml b/docs/user-guide/persistent-volumes/claims/claim-02.yaml
similarity index 100%
rename from examples/persistent-volumes/claims/claim-02.yaml
rename to docs/user-guide/persistent-volumes/claims/claim-02.yaml
diff --git a/examples/persistent-volumes/claims/claim-03.json b/docs/user-guide/persistent-volumes/claims/claim-03.json
similarity index 100%
rename from examples/persistent-volumes/claims/claim-03.json
rename to docs/user-guide/persistent-volumes/claims/claim-03.json
diff --git a/examples/persistent-volumes/simpletest/namespace.json b/docs/user-guide/persistent-volumes/simpletest/namespace.json
similarity index 100%
rename from examples/persistent-volumes/simpletest/namespace.json
rename to docs/user-guide/persistent-volumes/simpletest/namespace.json
diff --git a/examples/persistent-volumes/simpletest/pod.yaml b/docs/user-guide/persistent-volumes/simpletest/pod.yaml
similarity index 100%
rename from examples/persistent-volumes/simpletest/pod.yaml
rename to docs/user-guide/persistent-volumes/simpletest/pod.yaml
diff --git a/examples/persistent-volumes/simpletest/service.json b/docs/user-guide/persistent-volumes/simpletest/service.json
similarity index 100%
rename from examples/persistent-volumes/simpletest/service.json
rename to docs/user-guide/persistent-volumes/simpletest/service.json
diff --git a/examples/persistent-volumes/volumes/gce.yaml b/docs/user-guide/persistent-volumes/volumes/gce.yaml
similarity index 100%
rename from examples/persistent-volumes/volumes/gce.yaml
rename to docs/user-guide/persistent-volumes/volumes/gce.yaml
diff --git a/examples/persistent-volumes/volumes/local-01.yaml b/docs/user-guide/persistent-volumes/volumes/local-01.yaml
similarity index 100%
rename from examples/persistent-volumes/volumes/local-01.yaml
rename to docs/user-guide/persistent-volumes/volumes/local-01.yaml
diff --git a/examples/persistent-volumes/volumes/local-02.yaml b/docs/user-guide/persistent-volumes/volumes/local-02.yaml
similarity index 100%
rename from examples/persistent-volumes/volumes/local-02.yaml
rename to docs/user-guide/persistent-volumes/volumes/local-02.yaml
diff --git a/examples/persistent-volumes/volumes/nfs.yaml b/docs/user-guide/persistent-volumes/volumes/nfs.yaml
similarity index 100%
rename from examples/persistent-volumes/volumes/nfs.yaml
rename to docs/user-guide/persistent-volumes/volumes/nfs.yaml
diff --git a/docs/pod-states.md b/docs/user-guide/pod-states.md
similarity index 100%
rename from docs/pod-states.md
rename to docs/user-guide/pod-states.md
diff --git a/examples/pod.yaml b/docs/user-guide/pod.yaml
similarity index 100%
rename from examples/pod.yaml
rename to docs/user-guide/pod.yaml
diff --git a/docs/pods.md b/docs/user-guide/pods.md
similarity index 100%
rename from docs/pods.md
rename to docs/user-guide/pods.md
diff --git a/docs/replication-controller.md b/docs/user-guide/replication-controller.md
similarity index 100%
rename from docs/replication-controller.md
rename to docs/user-guide/replication-controller.md
diff --git a/examples/replication.yaml b/docs/user-guide/replication.yaml
similarity index 100%
rename from examples/replication.yaml
rename to docs/user-guide/replication.yaml
diff --git a/examples/resourcequota/README.md b/docs/user-guide/resourcequota/README.md
similarity index 100%
rename from examples/resourcequota/README.md
rename to docs/user-guide/resourcequota/README.md
diff --git a/examples/resourcequota/limits.yaml b/docs/user-guide/resourcequota/limits.yaml
similarity index 100%
rename from examples/resourcequota/limits.yaml
rename to docs/user-guide/resourcequota/limits.yaml
diff --git a/examples/resourcequota/namespace.yaml b/docs/user-guide/resourcequota/namespace.yaml
similarity index 100%
rename from examples/resourcequota/namespace.yaml
rename to docs/user-guide/resourcequota/namespace.yaml
diff --git a/examples/resourcequota/quota.yaml b/docs/user-guide/resourcequota/quota.yaml
similarity index 100%
rename from examples/resourcequota/quota.yaml
rename to docs/user-guide/resourcequota/quota.yaml
diff --git a/docs/secrets.md b/docs/user-guide/secrets.md
similarity index 100%
rename from docs/secrets.md
rename to docs/user-guide/secrets.md
diff --git a/examples/secrets/README.md b/docs/user-guide/secrets/README.md
similarity index 100%
rename from examples/secrets/README.md
rename to docs/user-guide/secrets/README.md
diff --git a/examples/secrets/secret-pod.yaml b/docs/user-guide/secrets/secret-pod.yaml
similarity index 100%
rename from examples/secrets/secret-pod.yaml
rename to docs/user-guide/secrets/secret-pod.yaml
diff --git a/examples/secrets/secret.yaml b/docs/user-guide/secrets/secret.yaml
similarity index 100%
rename from examples/secrets/secret.yaml
rename to docs/user-guide/secrets/secret.yaml
diff --git a/docs/security-context.md b/docs/user-guide/security-context.md
similarity index 100%
rename from docs/security-context.md
rename to docs/user-guide/security-context.md
diff --git a/docs/services-detail.png b/docs/user-guide/services-detail.png
similarity index 100%
rename from docs/services-detail.png
rename to docs/user-guide/services-detail.png
diff --git a/docs/services-detail.svg b/docs/user-guide/services-detail.svg
similarity index 100%
rename from docs/services-detail.svg
rename to docs/user-guide/services-detail.svg
diff --git a/docs/services-overview.png b/docs/user-guide/services-overview.png
similarity index 100%
rename from docs/services-overview.png
rename to docs/user-guide/services-overview.png
diff --git a/docs/services-overview.svg b/docs/user-guide/services-overview.svg
similarity index 100%
rename from docs/services-overview.svg
rename to docs/user-guide/services-overview.svg
diff --git a/docs/services.md b/docs/user-guide/services.md
similarity index 100%
rename from docs/services.md
rename to docs/user-guide/services.md
diff --git a/docs/sharing-clusters.md b/docs/user-guide/sharing-clusters.md
similarity index 100%
rename from docs/sharing-clusters.md
rename to docs/user-guide/sharing-clusters.md
diff --git a/examples/simple-nginx.md b/docs/user-guide/simple-nginx.md
similarity index 100%
rename from examples/simple-nginx.md
rename to docs/user-guide/simple-nginx.md
diff --git a/examples/simple-yaml.md b/docs/user-guide/simple-yaml.md
similarity index 100%
rename from examples/simple-yaml.md
rename to docs/user-guide/simple-yaml.md
diff --git a/docs/ui.md b/docs/user-guide/ui.md
similarity index 100%
rename from docs/ui.md
rename to docs/user-guide/ui.md
diff --git a/examples/update-demo/README.md b/docs/user-guide/update-demo/README.md
similarity index 100%
rename from examples/update-demo/README.md
rename to docs/user-guide/update-demo/README.md
diff --git a/examples/update-demo/build-images.sh b/docs/user-guide/update-demo/build-images.sh
similarity index 100%
rename from examples/update-demo/build-images.sh
rename to docs/user-guide/update-demo/build-images.sh
diff --git a/examples/update-demo/images/kitten/Dockerfile b/docs/user-guide/update-demo/images/kitten/Dockerfile
similarity index 100%
rename from examples/update-demo/images/kitten/Dockerfile
rename to docs/user-guide/update-demo/images/kitten/Dockerfile
diff --git a/examples/update-demo/images/kitten/html/data.json b/docs/user-guide/update-demo/images/kitten/html/data.json
similarity index 100%
rename from examples/update-demo/images/kitten/html/data.json
rename to docs/user-guide/update-demo/images/kitten/html/data.json
diff --git a/examples/update-demo/images/kitten/html/kitten.jpg b/docs/user-guide/update-demo/images/kitten/html/kitten.jpg
similarity index 100%
rename from examples/update-demo/images/kitten/html/kitten.jpg
rename to docs/user-guide/update-demo/images/kitten/html/kitten.jpg
diff --git a/examples/update-demo/images/nautilus/Dockerfile b/docs/user-guide/update-demo/images/nautilus/Dockerfile
similarity index 100%
rename from examples/update-demo/images/nautilus/Dockerfile
rename to docs/user-guide/update-demo/images/nautilus/Dockerfile
diff --git a/examples/update-demo/images/nautilus/html/data.json b/docs/user-guide/update-demo/images/nautilus/html/data.json
similarity index 100%
rename from examples/update-demo/images/nautilus/html/data.json
rename to docs/user-guide/update-demo/images/nautilus/html/data.json
diff --git a/examples/update-demo/images/nautilus/html/nautilus.jpg b/docs/user-guide/update-demo/images/nautilus/html/nautilus.jpg
similarity index 100%
rename from examples/update-demo/images/nautilus/html/nautilus.jpg
rename to docs/user-guide/update-demo/images/nautilus/html/nautilus.jpg
diff --git a/examples/update-demo/kitten-rc.yaml b/docs/user-guide/update-demo/kitten-rc.yaml
similarity index 100%
rename from examples/update-demo/kitten-rc.yaml
rename to docs/user-guide/update-demo/kitten-rc.yaml
diff --git a/examples/update-demo/local/LICENSE.angular b/docs/user-guide/update-demo/local/LICENSE.angular
similarity index 100%
rename from examples/update-demo/local/LICENSE.angular
rename to docs/user-guide/update-demo/local/LICENSE.angular
diff --git a/examples/update-demo/local/angular.min.js b/docs/user-guide/update-demo/local/angular.min.js
similarity index 100%
rename from examples/update-demo/local/angular.min.js
rename to docs/user-guide/update-demo/local/angular.min.js
diff --git a/examples/update-demo/local/angular.min.js.map b/docs/user-guide/update-demo/local/angular.min.js.map
similarity index 100%
rename from examples/update-demo/local/angular.min.js.map
rename to docs/user-guide/update-demo/local/angular.min.js.map
diff --git a/examples/update-demo/local/index.html b/docs/user-guide/update-demo/local/index.html
similarity index 100%
rename from examples/update-demo/local/index.html
rename to docs/user-guide/update-demo/local/index.html
diff --git a/examples/update-demo/local/script.js b/docs/user-guide/update-demo/local/script.js
similarity index 100%
rename from examples/update-demo/local/script.js
rename to docs/user-guide/update-demo/local/script.js
diff --git a/examples/update-demo/local/style.css b/docs/user-guide/update-demo/local/style.css
similarity index 100%
rename from examples/update-demo/local/style.css
rename to docs/user-guide/update-demo/local/style.css
diff --git a/examples/update-demo/nautilus-rc.yaml b/docs/user-guide/update-demo/nautilus-rc.yaml
similarity index 100%
rename from examples/update-demo/nautilus-rc.yaml
rename to docs/user-guide/update-demo/nautilus-rc.yaml
diff --git a/docs/user-guide.md b/docs/user-guide/user-guide.md
similarity index 100%
rename from docs/user-guide.md
rename to docs/user-guide/user-guide.md
diff --git a/docs/volumes.md b/docs/user-guide/volumes.md
similarity index 100%
rename from docs/volumes.md
rename to docs/user-guide/volumes.md
diff --git a/examples/walkthrough/README.md b/docs/user-guide/walkthrough/README.md
similarity index 100%
rename from examples/walkthrough/README.md
rename to docs/user-guide/walkthrough/README.md
diff --git a/examples/walkthrough/k8s201.md b/docs/user-guide/walkthrough/k8s201.md
similarity index 100%
rename from examples/walkthrough/k8s201.md
rename to docs/user-guide/walkthrough/k8s201.md
diff --git a/examples/walkthrough/pod-with-http-healthcheck.yaml b/docs/user-guide/walkthrough/pod-with-http-healthcheck.yaml
similarity index 100%
rename from examples/walkthrough/pod-with-http-healthcheck.yaml
rename to docs/user-guide/walkthrough/pod-with-http-healthcheck.yaml
diff --git a/examples/walkthrough/pod1.yaml b/docs/user-guide/walkthrough/pod1.yaml
similarity index 100%
rename from examples/walkthrough/pod1.yaml
rename to docs/user-guide/walkthrough/pod1.yaml
diff --git a/examples/walkthrough/pod2.yaml b/docs/user-guide/walkthrough/pod2.yaml
similarity index 100%
rename from examples/walkthrough/pod2.yaml
rename to docs/user-guide/walkthrough/pod2.yaml
diff --git a/examples/walkthrough/podtemplate.json b/docs/user-guide/walkthrough/podtemplate.json
similarity index 100%
rename from examples/walkthrough/podtemplate.json
rename to docs/user-guide/walkthrough/podtemplate.json
diff --git a/examples/walkthrough/replication-controller.yaml b/docs/user-guide/walkthrough/replication-controller.yaml
similarity index 100%
rename from examples/walkthrough/replication-controller.yaml
rename to docs/user-guide/walkthrough/replication-controller.yaml
diff --git a/examples/walkthrough/service.yaml b/docs/user-guide/walkthrough/service.yaml
similarity index 100%
rename from examples/walkthrough/service.yaml
rename to docs/user-guide/walkthrough/service.yaml
diff --git a/docs/working-with-resources.md b/docs/user-guide/working-with-resources.md
similarity index 100%
rename from docs/working-with-resources.md
rename to docs/user-guide/working-with-resources.md