Merge pull request #18047 from caesarxuchao/munger-tag-new

Stop munger produce the link to a release version doc if it doesn't exit in the release branch

Merge pull request #18047 from caesarxuchao/munger-tag-new
4ca66d2a · Brendan Burns · ac5c0aab · 2b2f2857 · 4ca66d2a · 4ca66d2a
Commit 4ca66d2a authored Dec 22, 2015 by Brendan Burns
325 changed files
--- a/cmd/mungedocs/mungedocs.go
+++ b/cmd/mungedocs/mungedocs.go
@@ -21,6 +21,7 @@ import (
 	"fmt"
 	"io/ioutil"
 	"os"
+	"os/exec"
 	"path"
 	"path/filepath"
 	"strings"
@@ -28,6 +29,9 @@ import (
 	flag "github.com/spf13/pflag"
 )
+// This needs to be updated when we cut a new release series.
+const latestReleaseBranch = "release-1.1"
 var (
 	verbose = flag.Bool("verbose", false, "On verification failure, emit pre-munge and post-munge versions.")
 	verify  = flag.Bool("verify", false, "Exit with status 1 if files would have needed changes but do not change.")
@@ -44,6 +48,11 @@ Examples:
 	ErrChangesNeeded = errors.New("mungedocs: changes required")
+	// This records the files in the rootDir in upstream/latest-release
+	filesInLatestRelease string
+	// This indicates if the munger is running inside Jenkins
+	inJenkins bool
 	// All of the munge operations to perform.
 	// TODO: allow selection from command line. (e.g., just check links in the examples directory.)
 	allMunges = []munge{
@@ -192,6 +201,26 @@ func main() {
 		os.Exit(2)
 	}
+	absRootDir, err := filepath.Abs(*rootDir)
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "ERROR: %v\n", err)
+		os.Exit(2)
+	}
+	inJenkins = len(os.Getenv("JENKINS_HOME")) != 0
+	out, err := exec.Command("git", "ls-tree", "-r", "--name-only", fmt.Sprintf("%s/%s", "upstream", latestReleaseBranch), absRootDir).CombinedOutput()
+	if err != nil {
+		if inJenkins {
+			fmt.Fprintf(os.Stderr, "output: %s,\nERROR: %v\n", out, err)
+			os.Exit(2)
+		} else {
+			fmt.Fprintf(os.Stdout, "output: %s,\nERROR: %v\n", out, err)
+			fmt.Fprintf(os.Stdout, "`git ls-tree -r --name-only upstream/%s failed. We'll ignore this error locally, but Jenkins may pick an error. Munger uses the output of this command to determine in unversioned warning, if it should add a link to the doc in release branch.\n", latestReleaseBranch)
+			filesInLatestRelease = ""
+		}
+	} else {
+		filesInLatestRelease = string(out)
+	}
 	fp := fileProcessor{
 		munges:     wantedMunges(),
 		verifyOnly: *verify,

--- a/cmd/mungedocs/unversioned_warning.go
+++ b/cmd/mungedocs/unversioned_warning.go
@@ -16,7 +16,10 @@ limitations under the License.
 package main
-import "fmt"
+import (
+	"fmt"
+	"strings"
+)
 const unversionedWarningTag = "UNVERSIONED_WARNING"
@@ -37,13 +40,14 @@ const unversionedWarningPre = `
 <h2>PLEASE NOTE: This document applies to the HEAD of the source tree</h2>
 If you are using a released version of Kubernetes, you should
-refer to the docs that go with that version.
+refer to the docs that go with that version.`
+const unversionedWarningLink = `
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
-`
+[here](http://releases.k8s.io/%s/%s).`
-const unversionedWarningFmt = `[here](http://releases.k8s.io/release-1.1/%s).`
 const unversionedWarningPost = `
@@ -56,8 +60,13 @@ Documentation for other releases can be found at
 `
-func makeUnversionedWarning(fileName string) mungeLines {
+func makeUnversionedWarning(fileName string, linkToReleaseDoc bool) mungeLines {
-	insert := unversionedWarningPre + fmt.Sprintf(unversionedWarningFmt, fileName) + unversionedWarningPost
+	var insert string
+	if linkToReleaseDoc {
+		insert = unversionedWarningPre + fmt.Sprintf(unversionedWarningLink, latestReleaseBranch, fileName) + unversionedWarningPost
+	} else {
+		insert = unversionedWarningPre + unversionedWarningPost
+	}
 	return getMungeLines(insert)
 }
@@ -71,11 +80,20 @@ func updateUnversionedWarning(file string, mlines mungeLines) (mungeLines, error
 		// No warnings on release branches
 		return mlines, nil
 	}
+	var linkToReleaseDoc bool
+	checkDocExistence := inJenkins || (len(filesInLatestRelease) != 0)
+	if checkDocExistence {
+		linkToReleaseDoc = strings.Contains(filesInLatestRelease, file)
+	} else {
+		linkToReleaseDoc = hasLine(mlines, "<!-- TAG RELEASE_LINK, added by the munger automatically -->")
+	}
 	if !hasMacroBlock(mlines, unversionedWarningTag) {
 		mlines = prependMacroBlock(unversionedWarningTag, mlines)
 	}
-	mlines, err = updateMacroBlock(mlines, unversionedWarningTag, makeUnversionedWarning(file))
+	mlines, err = updateMacroBlock(mlines, unversionedWarningTag, makeUnversionedWarning(file, linkToReleaseDoc))
 	if err != nil {
 		return mlines, err
 	}

--- a/cmd/mungedocs/unversioned_warning_test.go
+++ b/cmd/mungedocs/unversioned_warning_test.go
@@ -26,7 +26,7 @@ func TestUnversionedWarning(t *testing.T) {
 	beginMark := beginMungeTag(unversionedWarningTag)
 	endMark := endMungeTag(unversionedWarningTag)
-	warningString := makeUnversionedWarning("filename.md").String()
+	warningString := makeUnversionedWarning("filename.md", false).String()
 	warningBlock := beginMark + "\n" + warningString + endMark + "\n"
 	var cases = []struct {
 		in       string
@@ -68,3 +68,82 @@ func TestUnversionedWarning(t *testing.T) {
 		}
 	}
 }
+func TestMakeUnversionedWarning(t *testing.T) {
+	const fileName = "filename.md"
+	var cases = []struct {
+		linkToReleaseDoc bool
+		expected         string
+	}{
+		{
+			true,
+			`
+<!-- BEGIN STRIP_FOR_RELEASE -->
+<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
+     width="25" height="25">
+<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
+     width="25" height="25">
+<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
+     width="25" height="25">
+<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
+     width="25" height="25">
+<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
+     width="25" height="25">
+<h2>PLEASE NOTE: This document applies to the HEAD of the source tree</h2>
+If you are using a released version of Kubernetes, you should
+refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
+<strong>
+The latest release of this document can be found
+[here](http://releases.k8s.io/release-1.1/filename.md).
+Documentation for other releases can be found at
+[releases.k8s.io](http://releases.k8s.io).
+</strong>
+--
+<!-- END STRIP_FOR_RELEASE -->
+`,
+		},
+		{
+			false,
+			`
+<!-- BEGIN STRIP_FOR_RELEASE -->
+<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
+     width="25" height="25">
+<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
+     width="25" height="25">
+<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
+     width="25" height="25">
+<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
+     width="25" height="25">
+<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
+     width="25" height="25">
+<h2>PLEASE NOTE: This document applies to the HEAD of the source tree</h2>
+If you are using a released version of Kubernetes, you should
+refer to the docs that go with that version.
+Documentation for other releases can be found at
+[releases.k8s.io](http://releases.k8s.io).
+</strong>
+--
+<!-- END STRIP_FOR_RELEASE -->
+`,
+		},
+	}
+	for i, c := range cases {
+		if e, a := c.expected, makeUnversionedWarning(fileName, c.linkToReleaseDoc).String(); e != a {
+			t.Errorf("case[%d]: \nexpected %s\ngot %s", i, e, a)
+		}
+	}
+}
--- a/docs/README.md
+++ b/docs/README.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/README.md).

--- a/docs/admin/README.md
+++ b/docs/admin/README.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/README.md).

--- a/docs/admin/accessing-the-api.md
+++ b/docs/admin/accessing-the-api.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/accessing-the-api.md).

--- a/docs/admin/admission-controllers.md
+++ b/docs/admin/admission-controllers.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/admission-controllers.md).

--- a/docs/admin/authentication.md
+++ b/docs/admin/authentication.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/authentication.md).

--- a/docs/admin/authorization.md
+++ b/docs/admin/authorization.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/authorization.md).

--- a/docs/admin/cluster-components.md
+++ b/docs/admin/cluster-components.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/cluster-components.md).

--- a/docs/admin/cluster-large.md
+++ b/docs/admin/cluster-large.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/cluster-large.md).

--- a/docs/admin/cluster-management.md
+++ b/docs/admin/cluster-management.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/cluster-management.md).

--- a/docs/admin/cluster-troubleshooting.md
+++ b/docs/admin/cluster-troubleshooting.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/cluster-troubleshooting.md).

--- a/docs/admin/daemons.md
+++ b/docs/admin/daemons.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/daemons.md).

--- a/docs/admin/dns.md
+++ b/docs/admin/dns.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/dns.md).

--- a/docs/admin/etcd.md
+++ b/docs/admin/etcd.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/etcd.md).

--- a/docs/admin/garbage-collection.md
+++ b/docs/admin/garbage-collection.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/garbage-collection.md).

--- a/docs/admin/high-availability.md
+++ b/docs/admin/high-availability.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/high-availability.md).

--- a/docs/admin/introduction.md
+++ b/docs/admin/introduction.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/introduction.md).

--- a/docs/admin/kube-apiserver.md
+++ b/docs/admin/kube-apiserver.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/kube-apiserver.md).

--- a/docs/admin/kube-controller-manager.md
+++ b/docs/admin/kube-controller-manager.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/kube-controller-manager.md).

--- a/docs/admin/kube-proxy.md
+++ b/docs/admin/kube-proxy.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/kube-proxy.md).
@@ -73,7 +74,7 @@ kube-proxy
      --udp-timeout=250ms: How long an idle UDP connection will be kept open (e.g. '250ms', '2s').  Must be greater than 0. Only applicable for proxy-mode=userspace
 ```
-###### Auto generated by spf13/cobra on 21-Nov-2015
+###### Auto generated by spf13/cobra on 8-Dec-2015
 <!-- BEGIN MUNGE: GENERATED_ANALYTICS -->

--- a/docs/admin/kube-scheduler.md
+++ b/docs/admin/kube-scheduler.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/kube-scheduler.md).

--- a/docs/admin/kubelet.md
+++ b/docs/admin/kubelet.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/kubelet.md).
@@ -140,7 +141,7 @@ kubelet
      --tls-private-key-file="": File containing x509 private key matching --tls-cert-file.
 ```
-###### Auto generated by spf13/cobra on 4-Dec-2015
+###### Auto generated by spf13/cobra on 8-Dec-2015
 <!-- BEGIN MUNGE: GENERATED_ANALYTICS -->

--- a/docs/admin/limitrange/README.md
+++ b/docs/admin/limitrange/README.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/limitrange/README.md).

--- a/docs/admin/multi-cluster.md
+++ b/docs/admin/multi-cluster.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/multi-cluster.md).

--- a/docs/admin/namespaces.md
+++ b/docs/admin/namespaces.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/namespaces.md).

--- a/docs/admin/namespaces/README.md
+++ b/docs/admin/namespaces/README.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/namespaces/README.md).

--- a/docs/admin/networking.md
+++ b/docs/admin/networking.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/networking.md).

--- a/docs/admin/node.md
+++ b/docs/admin/node.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/node.md).

--- a/docs/admin/ovs-networking.md
+++ b/docs/admin/ovs-networking.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/ovs-networking.md).

--- a/docs/admin/resource-quota.md
+++ b/docs/admin/resource-quota.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/resource-quota.md).

--- a/docs/admin/resourcequota/README.md
+++ b/docs/admin/resourcequota/README.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/resourcequota/README.md).

--- a/docs/admin/salt.md
+++ b/docs/admin/salt.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/salt.md).

--- a/docs/admin/service-accounts-admin.md
+++ b/docs/admin/service-accounts-admin.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/service-accounts-admin.md).

--- a/docs/admin/static-pods.md
+++ b/docs/admin/static-pods.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/admin/static-pods.md).

--- a/docs/api-reference/extensions/v1beta1/definitions.md
+++ b/docs/api-reference/extensions/v1beta1/definitions.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/api-reference/extensions/v1beta1/definitions.md).

--- a/docs/api-reference/extensions/v1beta1/operations.md
+++ b/docs/api-reference/extensions/v1beta1/operations.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/api-reference/extensions/v1beta1/operations.md).

--- a/docs/api-reference/v1/definitions.md
+++ b/docs/api-reference/v1/definitions.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/api-reference/v1/definitions.md).

--- a/docs/api-reference/v1/operations.md
+++ b/docs/api-reference/v1/operations.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/api-reference/v1/operations.md).

--- a/docs/api.md
+++ b/docs/api.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/api.md).

--- a/docs/design/README.md
+++ b/docs/design/README.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/README.md).

--- a/docs/design/access.md
+++ b/docs/design/access.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/access.md).

--- a/docs/design/admission_control.md
+++ b/docs/design/admission_control.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/admission_control.md).

--- a/docs/design/admission_control_limit_range.md
+++ b/docs/design/admission_control_limit_range.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/admission_control_limit_range.md).

--- a/docs/design/admission_control_resource_quota.md
+++ b/docs/design/admission_control_resource_quota.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/admission_control_resource_quota.md).

--- a/docs/design/architecture.md
+++ b/docs/design/architecture.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/architecture.md).

--- a/docs/design/aws_under_the_hood.md
+++ b/docs/design/aws_under_the_hood.md
@@ -18,10 +18,6 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
-<strong>
-The latest release of this document can be found
-[here](http://releases.k8s.io/release-1.1/docs/design/aws_under_the_hood.md).
 Documentation for other releases can be found at
 [releases.k8s.io](http://releases.k8s.io).
 </strong>

--- a/docs/design/clustering.md
+++ b/docs/design/clustering.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/clustering.md).

--- a/docs/design/clustering/README.md
+++ b/docs/design/clustering/README.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/clustering/README.md).

--- a/docs/design/command_execution_port_forwarding.md
+++ b/docs/design/command_execution_port_forwarding.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/command_execution_port_forwarding.md).

--- a/docs/design/daemon.md
+++ b/docs/design/daemon.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/daemon.md).

--- a/docs/design/enhance-pluggable-policy.md
+++ b/docs/design/enhance-pluggable-policy.md
@@ -18,10 +18,6 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
-<strong>
-The latest release of this document can be found
-[here](http://releases.k8s.io/release-1.1/docs/design/enhance-pluggable-policy.md).
 Documentation for other releases can be found at
 [releases.k8s.io](http://releases.k8s.io).
 </strong>

--- a/docs/design/event_compression.md
+++ b/docs/design/event_compression.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/event_compression.md).

--- a/docs/design/expansion.md
+++ b/docs/design/expansion.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/expansion.md).

--- a/docs/design/extending-api.md
+++ b/docs/design/extending-api.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/extending-api.md).

--- a/docs/design/horizontal-pod-autoscaler.md
+++ b/docs/design/horizontal-pod-autoscaler.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/horizontal-pod-autoscaler.md).

--- a/docs/design/identifiers.md
+++ b/docs/design/identifiers.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/identifiers.md).

--- a/docs/design/namespaces.md
+++ b/docs/design/namespaces.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/namespaces.md).

--- a/docs/design/networking.md
+++ b/docs/design/networking.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/networking.md).

--- a/docs/design/persistent-storage.md
+++ b/docs/design/persistent-storage.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/persistent-storage.md).

--- a/docs/design/principles.md
+++ b/docs/design/principles.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/principles.md).

--- a/docs/design/resources.md
+++ b/docs/design/resources.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/resources.md).

--- a/docs/design/scheduler_extender.md
+++ b/docs/design/scheduler_extender.md
@@ -18,10 +18,6 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
-<strong>
-The latest release of this document can be found
-[here](http://releases.k8s.io/release-1.1/docs/design/scheduler_extender.md).
 Documentation for other releases can be found at
 [releases.k8s.io](http://releases.k8s.io).
 </strong>

--- a/docs/design/secrets.md
+++ b/docs/design/secrets.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/secrets.md).

--- a/docs/design/security.md
+++ b/docs/design/security.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/security.md).

--- a/docs/design/security_context.md
+++ b/docs/design/security_context.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/security_context.md).

--- a/docs/design/service_accounts.md
+++ b/docs/design/service_accounts.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/service_accounts.md).

--- a/docs/design/simple-rolling-update.md
+++ b/docs/design/simple-rolling-update.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/simple-rolling-update.md).

--- a/docs/design/versioning.md
+++ b/docs/design/versioning.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/design/versioning.md).

--- a/docs/devel/README.md
+++ b/docs/devel/README.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/README.md).

--- a/docs/devel/adding-an-APIGroup.md
+++ b/docs/devel/adding-an-APIGroup.md
@@ -18,10 +18,6 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
-<strong>
-The latest release of this document can be found
-[here](http://releases.k8s.io/release-1.1/docs/devel/adding-an-APIGroup.md).
 Documentation for other releases can be found at
 [releases.k8s.io](http://releases.k8s.io).
 </strong>

--- a/docs/devel/api-conventions.md
+++ b/docs/devel/api-conventions.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/api-conventions.md).

--- a/docs/devel/api_changes.md
+++ b/docs/devel/api_changes.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/api_changes.md).

--- a/docs/devel/automation.md
+++ b/docs/devel/automation.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/automation.md).

--- a/docs/devel/cherry-picks.md
+++ b/docs/devel/cherry-picks.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/cherry-picks.md).

--- a/docs/devel/cli-roadmap.md
+++ b/docs/devel/cli-roadmap.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/cli-roadmap.md).

--- a/docs/devel/client-libraries.md
+++ b/docs/devel/client-libraries.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/client-libraries.md).

--- a/docs/devel/coding-conventions.md
+++ b/docs/devel/coding-conventions.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/coding-conventions.md).

--- a/docs/devel/collab.md
+++ b/docs/devel/collab.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/collab.md).

--- a/docs/devel/developer-guides/vagrant.md
+++ b/docs/devel/developer-guides/vagrant.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/developer-guides/vagrant.md).

--- a/docs/devel/development.md
+++ b/docs/devel/development.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/development.md).

--- a/docs/devel/e2e-tests.md
+++ b/docs/devel/e2e-tests.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/e2e-tests.md).

--- a/docs/devel/faster_reviews.md
+++ b/docs/devel/faster_reviews.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/faster_reviews.md).

--- a/docs/devel/flaky-tests.md
+++ b/docs/devel/flaky-tests.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/flaky-tests.md).

--- a/docs/devel/getting-builds.md
+++ b/docs/devel/getting-builds.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/getting-builds.md).

--- a/docs/devel/instrumentation.md
+++ b/docs/devel/instrumentation.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/instrumentation.md).

--- a/docs/devel/issues.md
+++ b/docs/devel/issues.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/issues.md).

--- a/docs/devel/kubectl-conventions.md
+++ b/docs/devel/kubectl-conventions.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/kubectl-conventions.md).

--- a/docs/devel/kubemark-guide.md
+++ b/docs/devel/kubemark-guide.md
@@ -18,10 +18,6 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
-<strong>
-The latest release of this document can be found
-[here](http://releases.k8s.io/release-1.1/docs/devel/kubemark-guide.md).
 Documentation for other releases can be found at
 [releases.k8s.io](http://releases.k8s.io).
 </strong>

--- a/docs/devel/logging.md
+++ b/docs/devel/logging.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/logging.md).

--- a/docs/devel/making-release-notes.md
+++ b/docs/devel/making-release-notes.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/making-release-notes.md).

--- a/docs/devel/owners.md
+++ b/docs/devel/owners.md
@@ -18,10 +18,6 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
-<strong>
-The latest release of this document can be found
-[here](http://releases.k8s.io/release-1.1/docs/devel/owners.md).
 Documentation for other releases can be found at
 [releases.k8s.io](http://releases.k8s.io).
 </strong>

--- a/docs/devel/profiling.md
+++ b/docs/devel/profiling.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/profiling.md).

--- a/docs/devel/pull-requests.md
+++ b/docs/devel/pull-requests.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/pull-requests.md).

--- a/docs/devel/releasing.md
+++ b/docs/devel/releasing.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/releasing.md).

--- a/docs/devel/scheduler.md
+++ b/docs/devel/scheduler.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/scheduler.md).

--- a/docs/devel/scheduler_algorithm.md
+++ b/docs/devel/scheduler_algorithm.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/scheduler_algorithm.md).

--- a/docs/devel/update-release-docs.md
+++ b/docs/devel/update-release-docs.md
@@ -18,10 +18,6 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
-<strong>
-The latest release of this document can be found
-[here](http://releases.k8s.io/release-1.1/docs/devel/update-release-docs.md).
 Documentation for other releases can be found at
 [releases.k8s.io](http://releases.k8s.io).
 </strong>

--- a/docs/devel/writing-a-getting-started-guide.md
+++ b/docs/devel/writing-a-getting-started-guide.md
@@ -18,6 +18,7 @@
 If you are using a released version of Kubernetes, you should
 refer to the docs that go with that version.
+<!-- TAG RELEASE_LINK, added by the munger automatically -->
 <strong>
 The latest release of this document can be found
 [here](http://releases.k8s.io/release-1.1/docs/devel/writing-a-getting-started-guide.md).

--- a/docs/getting-started-guides/README.md
+++ b/docs/getting-started-guides/README.md
--- a/docs/getting-started-guides/aws.md
+++ b/docs/getting-started-guides/aws.md
--- a/docs/getting-started-guides/azure.md
+++ b/docs/getting-started-guides/azure.md
--- a/docs/getting-started-guides/binary_release.md
+++ b/docs/getting-started-guides/binary_release.md
--- a/docs/getting-started-guides/centos/centos_manual_config.md
+++ b/docs/getting-started-guides/centos/centos_manual_config.md
--- a/docs/getting-started-guides/cloudstack.md
+++ b/docs/getting-started-guides/cloudstack.md
--- a/docs/getting-started-guides/coreos.md
+++ b/docs/getting-started-guides/coreos.md
--- a/docs/getting-started-guides/coreos/azure/README.md
+++ b/docs/getting-started-guides/coreos/azure/README.md
--- a/docs/getting-started-guides/coreos/bare_metal_calico.md
+++ b/docs/getting-started-guides/coreos/bare_metal_calico.md
--- a/docs/getting-started-guides/coreos/bare_metal_offline.md
+++ b/docs/getting-started-guides/coreos/bare_metal_offline.md
--- a/docs/getting-started-guides/coreos/coreos_multinode_cluster.md
+++ b/docs/getting-started-guides/coreos/coreos_multinode_cluster.md
--- a/docs/getting-started-guides/dcos.md
+++ b/docs/getting-started-guides/dcos.md
--- a/docs/getting-started-guides/docker-multinode.md
+++ b/docs/getting-started-guides/docker-multinode.md
--- a/docs/getting-started-guides/docker-multinode/deployDNS.md
+++ b/docs/getting-started-guides/docker-multinode/deployDNS.md
--- a/docs/getting-started-guides/docker-multinode/master.md
+++ b/docs/getting-started-guides/docker-multinode/master.md
--- a/docs/getting-started-guides/docker-multinode/testing.md
+++ b/docs/getting-started-guides/docker-multinode/testing.md
--- a/docs/getting-started-guides/docker-multinode/worker.md
+++ b/docs/getting-started-guides/docker-multinode/worker.md
--- a/docs/getting-started-guides/docker.md
+++ b/docs/getting-started-guides/docker.md
--- a/docs/getting-started-guides/fedora/fedora-calico.md
+++ b/docs/getting-started-guides/fedora/fedora-calico.md
--- a/docs/getting-started-guides/fedora/fedora_ansible_config.md
+++ b/docs/getting-started-guides/fedora/fedora_ansible_config.md
--- a/docs/getting-started-guides/fedora/fedora_manual_config.md
+++ b/docs/getting-started-guides/fedora/fedora_manual_config.md
--- a/docs/getting-started-guides/fedora/flannel_multi_node_cluster.md
+++ b/docs/getting-started-guides/fedora/flannel_multi_node_cluster.md
--- a/docs/getting-started-guides/gce.md
+++ b/docs/getting-started-guides/gce.md
--- a/docs/getting-started-guides/juju.md
+++ b/docs/getting-started-guides/juju.md
--- a/docs/getting-started-guides/libvirt-coreos.md
+++ b/docs/getting-started-guides/libvirt-coreos.md
--- a/docs/getting-started-guides/locally.md
+++ b/docs/getting-started-guides/locally.md
--- a/docs/getting-started-guides/logging-elasticsearch.md
+++ b/docs/getting-started-guides/logging-elasticsearch.md
--- a/docs/getting-started-guides/logging.md
+++ b/docs/getting-started-guides/logging.md
--- a/docs/getting-started-guides/mesos-docker.md
+++ b/docs/getting-started-guides/mesos-docker.md
--- a/docs/getting-started-guides/mesos.md
+++ b/docs/getting-started-guides/mesos.md
--- a/docs/getting-started-guides/ovirt.md
+++ b/docs/getting-started-guides/ovirt.md
--- a/docs/getting-started-guides/rackspace.md
+++ b/docs/getting-started-guides/rackspace.md
--- a/docs/getting-started-guides/rkt/README.md
+++ b/docs/getting-started-guides/rkt/README.md
--- a/docs/getting-started-guides/scratch.md
+++ b/docs/getting-started-guides/scratch.md
--- a/docs/getting-started-guides/ubuntu-calico.md
+++ b/docs/getting-started-guides/ubuntu-calico.md
--- a/docs/getting-started-guides/ubuntu.md
+++ b/docs/getting-started-guides/ubuntu.md
--- a/docs/getting-started-guides/vagrant.md
+++ b/docs/getting-started-guides/vagrant.md
--- a/docs/getting-started-guides/vsphere.md
+++ b/docs/getting-started-guides/vsphere.md
--- a/docs/proposals/api-group.md
+++ b/docs/proposals/api-group.md
--- a/docs/proposals/apiserver-watch.md
+++ b/docs/proposals/apiserver-watch.md
--- a/docs/proposals/autoscaling.md
+++ b/docs/proposals/autoscaling.md
--- a/docs/proposals/client-package-structure.md
+++ b/docs/proposals/client-package-structure.md
--- a/docs/proposals/compute-resource-metrics-api.md
+++ b/docs/proposals/compute-resource-metrics-api.md
--- a/docs/proposals/configmap.md
+++ b/docs/proposals/configmap.md
--- a/docs/proposals/custom-metrics.md
+++ b/docs/proposals/custom-metrics.md
--- a/docs/proposals/deployment.md
+++ b/docs/proposals/deployment.md
--- a/docs/proposals/federation.md
+++ b/docs/proposals/federation.md
--- a/docs/proposals/flannel-integration.md
+++ b/docs/proposals/flannel-integration.md
--- a/docs/proposals/high-availability.md
+++ b/docs/proposals/high-availability.md
--- a/docs/proposals/initial-resources.md
+++ b/docs/proposals/initial-resources.md
--- a/docs/proposals/job.md
+++ b/docs/proposals/job.md
--- a/docs/proposals/kubemark.md
+++ b/docs/proposals/kubemark.md
--- a/docs/proposals/metrics-plumbing.md
+++ b/docs/proposals/metrics-plumbing.md
--- a/docs/proposals/multiple-schedulers.md
+++ b/docs/proposals/multiple-schedulers.md
--- a/docs/proposals/node-allocatable.md
+++ b/docs/proposals/node-allocatable.md
--- a/docs/proposals/performance-related-monitoring.md
+++ b/docs/proposals/performance-related-monitoring.md
--- a/docs/proposals/pod-security-context.md
+++ b/docs/proposals/pod-security-context.md
--- a/docs/proposals/rescheduler.md
+++ b/docs/proposals/rescheduler.md
--- a/docs/proposals/resource-qos.md
+++ b/docs/proposals/resource-qos.md
--- a/docs/proposals/scalability-testing.md
+++ b/docs/proposals/scalability-testing.md
--- a/docs/proposals/selinux.md
+++ b/docs/proposals/selinux.md
--- a/docs/proposals/volume-ownership-management.md
+++ b/docs/proposals/volume-ownership-management.md
--- a/docs/proposals/volumes.md
+++ b/docs/proposals/volumes.md
--- a/docs/reporting-security-issues.md
+++ b/docs/reporting-security-issues.md
--- a/docs/roadmap.md
+++ b/docs/roadmap.md
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
--- a/docs/user-guide/README.md
+++ b/docs/user-guide/README.md
--- a/docs/user-guide/accessing-the-cluster.md
+++ b/docs/user-guide/accessing-the-cluster.md
--- a/docs/user-guide/annotations.md
+++ b/docs/user-guide/annotations.md
--- a/docs/user-guide/application-troubleshooting.md
+++ b/docs/user-guide/application-troubleshooting.md
--- a/docs/user-guide/compute-resources.md
+++ b/docs/user-guide/compute-resources.md
--- a/docs/user-guide/config-best-practices.md
+++ b/docs/user-guide/config-best-practices.md
--- a/docs/user-guide/configuring-containers.md
+++ b/docs/user-guide/configuring-containers.md
--- a/docs/user-guide/connecting-applications.md
+++ b/docs/user-guide/connecting-applications.md
--- a/docs/user-guide/connecting-to-applications-port-forward.md
+++ b/docs/user-guide/connecting-to-applications-port-forward.md
--- a/docs/user-guide/connecting-to-applications-proxy.md
+++ b/docs/user-guide/connecting-to-applications-proxy.md
--- a/docs/user-guide/container-environment.md
+++ b/docs/user-guide/container-environment.md
--- a/docs/user-guide/containers.md
+++ b/docs/user-guide/containers.md
--- a/docs/user-guide/debugging-services.md
+++ b/docs/user-guide/debugging-services.md
--- a/docs/user-guide/deploying-applications.md
+++ b/docs/user-guide/deploying-applications.md
--- a/docs/user-guide/deployments.md
+++ b/docs/user-guide/deployments.md
--- a/docs/user-guide/docker-cli-to-kubectl.md
+++ b/docs/user-guide/docker-cli-to-kubectl.md
--- a/docs/user-guide/downward-api.md
+++ b/docs/user-guide/downward-api.md
--- a/docs/user-guide/downward-api/README.md
+++ b/docs/user-guide/downward-api/README.md
--- a/docs/user-guide/downward-api/volume/README.md
+++ b/docs/user-guide/downward-api/volume/README.md
--- a/docs/user-guide/environment-guide/README.md
+++ b/docs/user-guide/environment-guide/README.md
--- a/docs/user-guide/environment-guide/containers/README.md
+++ b/docs/user-guide/environment-guide/containers/README.md
--- a/docs/user-guide/getting-into-containers.md
+++ b/docs/user-guide/getting-into-containers.md
--- a/docs/user-guide/horizontal-pod-autoscaler.md
+++ b/docs/user-guide/horizontal-pod-autoscaler.md
--- a/docs/user-guide/horizontal-pod-autoscaling/README.md
+++ b/docs/user-guide/horizontal-pod-autoscaling/README.md
--- a/docs/user-guide/identifiers.md
+++ b/docs/user-guide/identifiers.md
--- a/docs/user-guide/images.md
+++ b/docs/user-guide/images.md
--- a/docs/user-guide/ingress.md
+++ b/docs/user-guide/ingress.md
--- a/docs/user-guide/introspection-and-debugging.md
+++ b/docs/user-guide/introspection-and-debugging.md
--- a/docs/user-guide/jobs.md
+++ b/docs/user-guide/jobs.md
--- a/docs/user-guide/jsonpath.md
+++ b/docs/user-guide/jsonpath.md
--- a/docs/user-guide/known-issues.md
+++ b/docs/user-guide/known-issues.md
--- a/docs/user-guide/kubeconfig-file.md
+++ b/docs/user-guide/kubeconfig-file.md
--- a/docs/user-guide/kubectl-cheatsheet.md
+++ b/docs/user-guide/kubectl-cheatsheet.md
--- a/docs/user-guide/kubectl-overview.md
+++ b/docs/user-guide/kubectl-overview.md
--- a/docs/user-guide/kubectl/kubectl.md
+++ b/docs/user-guide/kubectl/kubectl.md
--- a/docs/user-guide/kubectl/kubectl_annotate.md
+++ b/docs/user-guide/kubectl/kubectl_annotate.md
--- a/docs/user-guide/kubectl/kubectl_api-versions.md
+++ b/docs/user-guide/kubectl/kubectl_api-versions.md
--- a/docs/user-guide/kubectl/kubectl_apply.md
+++ b/docs/user-guide/kubectl/kubectl_apply.md
--- a/docs/user-guide/kubectl/kubectl_attach.md
+++ b/docs/user-guide/kubectl/kubectl_attach.md
--- a/docs/user-guide/kubectl/kubectl_autoscale.md
+++ b/docs/user-guide/kubectl/kubectl_autoscale.md
--- a/docs/user-guide/kubectl/kubectl_cluster-info.md
+++ b/docs/user-guide/kubectl/kubectl_cluster-info.md
--- a/docs/user-guide/kubectl/kubectl_config.md
+++ b/docs/user-guide/kubectl/kubectl_config.md
--- a/docs/user-guide/kubectl/kubectl_config_set-cluster.md
+++ b/docs/user-guide/kubectl/kubectl_config_set-cluster.md
--- a/docs/user-guide/kubectl/kubectl_config_set-context.md
+++ b/docs/user-guide/kubectl/kubectl_config_set-context.md
--- a/docs/user-guide/kubectl/kubectl_config_set-credentials.md
+++ b/docs/user-guide/kubectl/kubectl_config_set-credentials.md
--- a/docs/user-guide/kubectl/kubectl_config_set.md
+++ b/docs/user-guide/kubectl/kubectl_config_set.md
--- a/docs/user-guide/kubectl/kubectl_config_unset.md
+++ b/docs/user-guide/kubectl/kubectl_config_unset.md
--- a/docs/user-guide/kubectl/kubectl_config_use-context.md
+++ b/docs/user-guide/kubectl/kubectl_config_use-context.md
--- a/docs/user-guide/kubectl/kubectl_config_view.md
+++ b/docs/user-guide/kubectl/kubectl_config_view.md
--- a/docs/user-guide/kubectl/kubectl_convert.md
+++ b/docs/user-guide/kubectl/kubectl_convert.md
--- a/docs/user-guide/kubectl/kubectl_create.md
+++ b/docs/user-guide/kubectl/kubectl_create.md
--- a/docs/user-guide/kubectl/kubectl_create_namespace.md
+++ b/docs/user-guide/kubectl/kubectl_create_namespace.md
--- a/docs/user-guide/kubectl/kubectl_create_secret.md
+++ b/docs/user-guide/kubectl/kubectl_create_secret.md
--- a/docs/user-guide/kubectl/kubectl_create_secret_docker-registry.md
+++ b/docs/user-guide/kubectl/kubectl_create_secret_docker-registry.md
--- a/docs/user-guide/kubectl/kubectl_create_secret_generic.md
+++ b/docs/user-guide/kubectl/kubectl_create_secret_generic.md
--- a/docs/user-guide/kubectl/kubectl_delete.md
+++ b/docs/user-guide/kubectl/kubectl_delete.md
--- a/docs/user-guide/kubectl/kubectl_describe.md
+++ b/docs/user-guide/kubectl/kubectl_describe.md
--- a/docs/user-guide/kubectl/kubectl_edit.md
+++ b/docs/user-guide/kubectl/kubectl_edit.md
--- a/docs/user-guide/kubectl/kubectl_exec.md
+++ b/docs/user-guide/kubectl/kubectl_exec.md
--- a/docs/user-guide/kubectl/kubectl_explain.md
+++ b/docs/user-guide/kubectl/kubectl_explain.md
--- a/docs/user-guide/kubectl/kubectl_expose.md
+++ b/docs/user-guide/kubectl/kubectl_expose.md
--- a/docs/user-guide/kubectl/kubectl_get.md
+++ b/docs/user-guide/kubectl/kubectl_get.md
--- a/docs/user-guide/kubectl/kubectl_label.md
+++ b/docs/user-guide/kubectl/kubectl_label.md
--- a/docs/user-guide/kubectl/kubectl_logs.md
+++ b/docs/user-guide/kubectl/kubectl_logs.md
--- a/docs/user-guide/kubectl/kubectl_namespace.md
+++ b/docs/user-guide/kubectl/kubectl_namespace.md
--- a/docs/user-guide/kubectl/kubectl_patch.md
+++ b/docs/user-guide/kubectl/kubectl_patch.md
--- a/docs/user-guide/kubectl/kubectl_port-forward.md
+++ b/docs/user-guide/kubectl/kubectl_port-forward.md
--- a/docs/user-guide/kubectl/kubectl_proxy.md
+++ b/docs/user-guide/kubectl/kubectl_proxy.md
--- a/docs/user-guide/kubectl/kubectl_replace.md
+++ b/docs/user-guide/kubectl/kubectl_replace.md
--- a/docs/user-guide/kubectl/kubectl_rolling-update.md
+++ b/docs/user-guide/kubectl/kubectl_rolling-update.md
--- a/docs/user-guide/kubectl/kubectl_run.md
+++ b/docs/user-guide/kubectl/kubectl_run.md
--- a/docs/user-guide/kubectl/kubectl_scale.md
+++ b/docs/user-guide/kubectl/kubectl_scale.md
--- a/docs/user-guide/kubectl/kubectl_stop.md
+++ b/docs/user-guide/kubectl/kubectl_stop.md
--- a/docs/user-guide/kubectl/kubectl_version.md
+++ b/docs/user-guide/kubectl/kubectl_version.md
--- a/docs/user-guide/labels.md
+++ b/docs/user-guide/labels.md
--- a/docs/user-guide/liveness/README.md
+++ b/docs/user-guide/liveness/README.md
--- a/docs/user-guide/logging-demo/README.md
+++ b/docs/user-guide/logging-demo/README.md
--- a/docs/user-guide/logging.md
+++ b/docs/user-guide/logging.md
--- a/docs/user-guide/managing-deployments.md
+++ b/docs/user-guide/managing-deployments.md
--- a/docs/user-guide/monitoring.md
+++ b/docs/user-guide/monitoring.md
--- a/docs/user-guide/namespaces.md
+++ b/docs/user-guide/namespaces.md
--- a/docs/user-guide/node-selection/README.md
+++ b/docs/user-guide/node-selection/README.md
--- a/docs/user-guide/overview.md
+++ b/docs/user-guide/overview.md
--- a/docs/user-guide/persistent-volumes.md
+++ b/docs/user-guide/persistent-volumes.md
--- a/docs/user-guide/persistent-volumes/README.md
+++ b/docs/user-guide/persistent-volumes/README.md
--- a/docs/user-guide/pod-states.md
+++ b/docs/user-guide/pod-states.md
--- a/docs/user-guide/pods.md
+++ b/docs/user-guide/pods.md
--- a/docs/user-guide/prereqs.md
+++ b/docs/user-guide/prereqs.md
--- a/docs/user-guide/production-pods.md
+++ b/docs/user-guide/production-pods.md
--- a/docs/user-guide/quick-start.md
+++ b/docs/user-guide/quick-start.md
--- a/docs/user-guide/replication-controller.md
+++ b/docs/user-guide/replication-controller.md
--- a/docs/user-guide/resourcequota/README.md
+++ b/docs/user-guide/resourcequota/README.md
--- a/docs/user-guide/secrets.md
+++ b/docs/user-guide/secrets.md
--- a/docs/user-guide/secrets/README.md
+++ b/docs/user-guide/secrets/README.md
--- a/docs/user-guide/security-context.md
+++ b/docs/user-guide/security-context.md
--- a/docs/user-guide/service-accounts.md
+++ b/docs/user-guide/service-accounts.md
--- a/docs/user-guide/services-firewalls.md
+++ b/docs/user-guide/services-firewalls.md
--- a/docs/user-guide/services.md
+++ b/docs/user-guide/services.md
--- a/docs/user-guide/sharing-clusters.md
+++ b/docs/user-guide/sharing-clusters.md
--- a/docs/user-guide/simple-nginx.md
+++ b/docs/user-guide/simple-nginx.md
--- a/docs/user-guide/simple-yaml.md
+++ b/docs/user-guide/simple-yaml.md
--- a/docs/user-guide/ui.md
+++ b/docs/user-guide/ui.md
--- a/docs/user-guide/update-demo/README.md
+++ b/docs/user-guide/update-demo/README.md
--- a/docs/user-guide/volumes.md
+++ b/docs/user-guide/volumes.md
--- a/docs/user-guide/walkthrough/README.md
+++ b/docs/user-guide/walkthrough/README.md
--- a/docs/user-guide/walkthrough/k8s201.md
+++ b/docs/user-guide/walkthrough/k8s201.md
--- a/docs/user-guide/working-with-resources.md
+++ b/docs/user-guide/working-with-resources.md
--- a/docs/whatisk8s.md
+++ b/docs/whatisk8s.md
--- a/examples/README.md
+++ b/examples/README.md
--- a/examples/aws_ebs/README.md
+++ b/examples/aws_ebs/README.md
--- a/examples/blog-logging/diagrams/README.md
+++ b/examples/blog-logging/diagrams/README.md
--- a/examples/cassandra/README.md
+++ b/examples/cassandra/README.md
--- a/examples/celery-rabbitmq/README.md
+++ b/examples/celery-rabbitmq/README.md
--- a/examples/cephfs/README.md
+++ b/examples/cephfs/README.md
--- a/examples/cluster-dns/README.md
+++ b/examples/cluster-dns/README.md
--- a/examples/elasticsearch/README.md
+++ b/examples/elasticsearch/README.md
--- a/examples/elasticsearch/production_cluster/README.md
+++ b/examples/elasticsearch/production_cluster/README.md
--- a/examples/experimental/persistent-volume-provisioning/README.md
+++ b/examples/experimental/persistent-volume-provisioning/README.md
--- a/examples/explorer/README.md
+++ b/examples/explorer/README.md
--- a/examples/fibre_channel/README.md
+++ b/examples/fibre_channel/README.md
--- a/examples/flocker/README.md
+++ b/examples/flocker/README.md
--- a/examples/glusterfs/README.md
+++ b/examples/glusterfs/README.md
--- a/examples/guestbook-go/README.md
+++ b/examples/guestbook-go/README.md
--- a/examples/guestbook-go/_src/README.md
+++ b/examples/guestbook-go/_src/README.md
--- a/examples/guestbook/README.md
+++ b/examples/guestbook/README.md
--- a/examples/hazelcast/README.md
+++ b/examples/hazelcast/README.md
--- a/examples/https-nginx/README.md
+++ b/examples/https-nginx/README.md
--- a/examples/iscsi/README.md
+++ b/examples/iscsi/README.md
--- a/examples/javaee/README.md
+++ b/examples/javaee/README.md
--- a/examples/javaweb-tomcat-sidecar/README.md
+++ b/examples/javaweb-tomcat-sidecar/README.md
--- a/examples/job/expansions/README.md
+++ b/examples/job/expansions/README.md
--- a/examples/job/work-queue-1/README.md
+++ b/examples/job/work-queue-1/README.md
--- a/examples/job/work-queue-2/README.md
+++ b/examples/job/work-queue-2/README.md
--- a/examples/k8petstore/README.md
+++ b/examples/k8petstore/README.md
--- a/examples/k8petstore/bps-data-generator/README.md
+++ b/examples/k8petstore/bps-data-generator/README.md
--- a/examples/kubectl-container/README.md
+++ b/examples/kubectl-container/README.md
--- a/examples/meteor/README.md
+++ b/examples/meteor/README.md
--- a/examples/meteor/dockerbase/README.md
+++ b/examples/meteor/dockerbase/README.md
--- a/examples/mysql-cinder-pd/README.md
+++ b/examples/mysql-cinder-pd/README.md
--- a/examples/mysql-galera/README.md
+++ b/examples/mysql-galera/README.md
--- a/examples/mysql-wordpress-pd/README.md
+++ b/examples/mysql-wordpress-pd/README.md
--- a/examples/newrelic/README.md
+++ b/examples/newrelic/README.md
--- a/examples/nfs/README.md
+++ b/examples/nfs/README.md
--- a/examples/nfs/nfs-data/README.md
+++ b/examples/nfs/nfs-data/README.md
--- a/examples/nodesjs-mongodb/README.md
+++ b/examples/nodesjs-mongodb/README.md
--- a/examples/openshift-origin/README.md
+++ b/examples/openshift-origin/README.md
--- a/examples/phabricator/README.md
+++ b/examples/phabricator/README.md
--- a/examples/rbd/README.md
+++ b/examples/rbd/README.md
--- a/examples/redis/README.md
+++ b/examples/redis/README.md
--- a/examples/rethinkdb/README.md
+++ b/examples/rethinkdb/README.md
--- a/examples/runtime-constraints/README.md
+++ b/examples/runtime-constraints/README.md
--- a/examples/selenium/README.md
+++ b/examples/selenium/README.md
--- a/examples/sharing-clusters/README.md
+++ b/examples/sharing-clusters/README.md
--- a/examples/simple-nginx.md
+++ b/examples/simple-nginx.md
--- a/examples/spark/README.md
+++ b/examples/spark/README.md
--- a/examples/spark/images/driver/README.md
+++ b/examples/spark/images/driver/README.md
--- a/examples/spark/spark-gluster/README.md
+++ b/examples/spark/spark-gluster/README.md
--- a/examples/storm/README.md
+++ b/examples/storm/README.md
--- a/examples/vitess/README.md
+++ b/examples/vitess/README.md