diff --git a/docs/devel/development.md b/docs/devel/development.md
index 32cb17cbbf1..1275a0a5da9 100644
--- a/docs/devel/development.md
+++ b/docs/devel/development.md
@@ -88,6 +88,21 @@ To build binaries for all platforms:
         make cross
 ```
 
+### How to update the Go version used to test & build k8s
+
+The kubernetes project tries to stay on the latest version of Go so it can
+benefit from the improvements to the language over time and can easily
+bump to a minor release version for security updates.
+
+Since kubernetes is mostly built and tested in containers, there are a few
+unique places you need to update the go version.
+
+- The image for cross compiling in [build/build-image/cross/](../../build/build-image/cross/). The `VERSION` file and `Dockerfile`.
+- The jenkins test-image in
+  [hack/jenkins/test-image/](../../hack/jenkins/test-image/). The `Dockerfile` and `Makefile`.
+- The docker image being run in [hack/jenkins/dockerized-e2e-runner.sh](../../hack/jenkins/dockerized-e2e-runner.sh) and [hack/jenkins/gotest-dockerized.sh](../../hack/jenkins/gotest-dockerized.sh).
+- The cross tag `KUBE_BUILD_IMAGE_CROSS_TAG` in [build/common.sh](../../build/common.sh)
+
 ## Workflow
 
 Below, we outline one of the more common git workflows that core developers use.
@@ -340,6 +355,8 @@ hack/update-generated-docs.sh
 ```
 
 
+
+
 <!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
 [![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/devel/development.md?pixel)]()
 <!-- END MUNGE: GENERATED_ANALYTICS -->
diff --git a/docs/devel/go-code.md b/docs/devel/go-code.md
index 01b9c45cea6..e6416bedc1d 100644
--- a/docs/devel/go-code.md
+++ b/docs/devel/go-code.md
@@ -36,6 +36,8 @@ and tips that our developers have found useful.
 ## Recommended Reading
 
 - [Kubernetes Go development environment](development.md#go-development-environment)
+- [The Go Spec](https://golang.org/ref/spec) - The Go Programming Language
+  Specification.
 - [Go Tour](https://tour.golang.org/welcome/2) - Official Go tutorial.
 - [Effective Go](https://golang.org/doc/effective_go.html) - A good collection of Go advice.
 - [Kubernetes Code conventions](coding-conventions.md) - Style guide for Kubernetes code.