Fixes per code review

_data/guides.yml

@@ -12,7 +12,7 @@ toc:
     path: /docs/getting-started-guides/kubeadm/
   - title: Hello World on Google Container Engine
     path: /docs/hellonode/
-  - title: Downloading kubectl
+  - title: Installing kubectl
     path: /docs/getting-started-guides/kubectl/
   - title: Downloading or Building Kubernetes
     path: /docs/getting-started-guides/binary_release/

docs/getting-started-guides/kubectl.md

@@ -7,10 +7,12 @@ li>.highlighter-rouge {position:relative; top:3px;}
 
 ## Overview
 
-kubectl is the command line tool you will use when interacting with kubernetes.
+kubectl is the command line tool you use to interact with Kubernetes clusters.
 
-You should use a version of kubectl that is newer than your server.  `kubectl version` will print
+You should use a version of kubectl that is at least as new as your server.
-the server and client versions.
+`kubectl version` will print the server and client versions.  Using the same version of kubectl
+as your server naturally works; using a newer kubectl than your server also works; but if you use
+an older kubectl with a newer server you may see odd validation errors .
 
 ## Download a release
 
@@ -18,16 +20,16 @@ Download kubectl from the [official Kubernetes releases](https://console.cloud.g
 
 On MacOS:
 
-```
+```shell
-wget https://storage.googleapis.com/kubernetes-release/release/v1.4.3/bin/darwin/amd64/kubectl
+wget https://storage.googleapis.com/kubernetes-release/release/v1.4.4/bin/darwin/amd64/kubectl
 chmod +x kubectl
 mv kubectl /usr/local/bin/kubectl
 ```
 
 On Linux:
 
-```
+```shell
-wget https://storage.googleapis.com/kubernetes-release/release/v1.4.3/bin/linux/amd64/kubectl
+wget https://storage.googleapis.com/kubernetes-release/release/v1.4.4/bin/linux/amd64/kubectl
 chmod +x kubectl
 mv kubectl /usr/local/bin/kubectl
 ```
@@ -50,7 +52,7 @@ After Google Cloud SDK installs, run the following command to install `kubectl`:
 gcloud components install kubectl
 ```
 
-Do check that the version is sufficiently up-to-date using `kubectl version --client`. 
+Do check that the version is sufficiently up-to-date using `kubectl version`.
 
 ### Install with brew
 
@@ -60,4 +62,5 @@ If you are on MacOS and using brew, you can install with:
 brew install kubectl
 ```
 
-Do check that the version is sufficiently up-to-date using `kubectl version --client`. 
+The homebrew project is independent from kubernetes, so do check that the version is
+sufficiently up-to-date using `kubectl version`.