Merge pull request #382 from monopole/combineDemos

combine demos into a subdir

cmd/kinflate/README.md

@@ -40,10 +40,8 @@ and your `PATH` contains `$GOPATH/bin`:
 go get k8s.io/kubectl/cmd/kinflate
 ```
 
-Note: golang 1.10 or newer is required.
-
 ## Demos
 
- * [hello world one-pager](demoHelloWorldShort.md)
- * [hello world, with instances, slide format](demoHelloWorldLong/README.md)
- * [mysql one-pager](demoMySql.md)
+ * [hello world one-pager](demo/helloWorldOnePager.md)
+ * [hello world detailed](demo/helloWorldDetailed/README.md) (with instances, in slide format)
+ * [mysql one-pager](demo/mySql.md)

cmd/kinflate/demo/helloWorldDetailed/README.md

@@ -1,10 +1,11 @@
 # Demo: hello world with instances
 
-Goal:
+Steps:
 
- 1. Clone a simple off-the-shelf example as a base configuration.
+ 1. Clone an off-the-shelf configuration as your base.
  1. Customize it.
- 1. Create two different instances based on the customization.
+ 1. Create two different instances (_staging_ and _production_)
+    from your customized base.
 
 First define a place to work:
 

cmd/kinflate/demo/helloWorldDetailed/overlays/production/manifest.md

@@ -10,7 +10,6 @@ apiVersion: manifest.k8s.io/v1alpha1
 kind: Package
 metadata:
   name: makes-production-tuthello
-# description: hello configured for production
 namePrefix: production-
 objectLabels:
   instance: production

cmd/kinflate/demo/helloWorldDetailed/overlays/staging/manifest.md

@@ -10,7 +10,6 @@ apiVersion: manifest.k8s.io/v1alpha1
 kind: Package
 metadata:
   name: makes-staging-hello
-# description: hello configured for staging
 namePrefix: staging-
 objectLabels:
   instance: staging

cmd/kinflate/demo/helloWorldOnePager.md

@@ -4,8 +4,8 @@
 
 Steps:
 
- 1. Clone an off-the-shelf example configuration.
- 1. Customizes the resources in it with a name prefix.
+ 1. Clone an off-the-shelf configuration.
+ 1. Customize its resources with a name prefix.
  1. Apply the result to a cluster via [kubectl].
 
 First make a place to work:

cmd/kinflate/demo/mySql.md

@@ -1,4 +1,4 @@
-# MySql Example
+# Demo: MySql
 
 This example takes some off-the-shelf k8s resources
 designed for MySQL, and customizes them to suit a