From 0ebd20ccfbb56b1e3730ad5d559de5e7377d12a8 Mon Sep 17 00:00:00 2001
From: Justin Santa Barbara <justin@fathomdb.com>
Date: Fri, 21 Oct 2016 21:05:23 -0400
Subject: [PATCH] Fixes per code review

---
 _data/guides.yml                       |  2 +-
 docs/getting-started-guides/kubectl.md | 21 ++++++++++++---------
 2 files changed, 13 insertions(+), 10 deletions(-)

diff --git a/_data/guides.yml b/_data/guides.yml
index e77e8e1b01..a661cbfb9a 100644
--- a/_data/guides.yml
+++ b/_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/
diff --git a/docs/getting-started-guides/kubectl.md b/docs/getting-started-guides/kubectl.md
index 6c5043e744..0498ceb646 100644
--- a/docs/getting-started-guides/kubectl.md
+++ b/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
-the server and client versions.
+You should use a version of kubectl that is at least as new as your server.
+`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:
 
-```
-wget https://storage.googleapis.com/kubernetes-release/release/v1.4.3/bin/darwin/amd64/kubectl
+```shell
+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:
 
-```
-wget https://storage.googleapis.com/kubernetes-release/release/v1.4.3/bin/linux/amd64/kubectl
+```shell
+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`.
\ No newline at end of file