Docs should show how to pull a particular release (kubeflow#524)

* Update the docs to explain how to pin to a particular version.

* Create a new commit to see about the presubmits.

* Version needs to be included in the pkg install step.

README.md

@@ -71,17 +71,23 @@ In order to quickly set up all components, execute the following commands:
 NAMESPACE=kubeflow
 kubectl create namespace ${NAMESPACE}
 
+# Which version of Kubeflow to use
+# For a list of releases refer to:
+# https://github.com/kubeflow/kubeflow/releases
+VERSION=v0.1.0-rc.0
+
 # Initialize a ksonnet app. Set the namespace for it's default environment.
 APP_NAME=my-kubeflow
 ks init ${APP_NAME}
 cd ${APP_NAME}
 ks env set default --namespace ${NAMESPACE}
 
 # Install Kubeflow components
-ks registry add kubeflow github.com/kubeflow/kubeflow/tree/master/kubeflow
-ks pkg install kubeflow/core
-ks pkg install kubeflow/tf-serving
-ks pkg install kubeflow/tf-job
+ks registry add kubeflow github.com/kubeflow/kubeflow/tree/${VERSION}/kubeflow
+
+ks pkg install kubeflow/core@${VERSION}
+ks pkg install kubeflow/tf-serving@${VERSION}
+ks pkg install kubeflow/tf-job@${VERSION}
 
 # Create templates for core components
 ks generate kubeflow-core kubeflow-core

user_guide.md

@@ -23,11 +23,15 @@ ks init my-kubeflow
 Install the Kubeflow packages into your application.
 
 ```
+# For a list of releases see:
+# https://github.com/kubeflow/kubeflow/releases
+VERSION=v0.1.0-rc.0
+
 cd my-kubeflow
-ks registry add kubeflow github.com/kubeflow/kubeflow/tree/master/kubeflow
-ks pkg install kubeflow/core
-ks pkg install kubeflow/tf-serving
-ks pkg install kubeflow/tf-job
+ks registry add kubeflow github.com/kubeflow/kubeflow/tree/${VERSION}/kubeflow
+ks pkg install kubeflow/core@${VERSION}
+ks pkg install kubeflow/tf-serving@${VERSION}
+ks pkg install kubeflow/tf-job@${VERSION}
 ```
 
 Create the Kubeflow core component. The core component includes: