From 7644845b9ec47f24fbec60bfdeb5b5add504415e Mon Sep 17 00:00:00 2001
From: Marek Biskup <biskup@google.com>
Date: Fri, 19 Jun 2015 17:41:12 +0200
Subject: [PATCH] add links to unlinked documents; move making-release-notes.md
 to docs/devel

---
 docs/devel/README.md                     |  2 ++
 docs/{ => devel}/making-release-notes.md |  0
 docs/user-guide.md                       | 15 +++++++++++++--
 3 files changed, 15 insertions(+), 2 deletions(-)
 rename docs/{ => devel}/making-release-notes.md (100%)

diff --git a/docs/devel/README.md b/docs/devel/README.md
index 13ccc42de0..3ee8a24408 100644
--- a/docs/devel/README.md
+++ b/docs/devel/README.md
@@ -6,6 +6,8 @@ Docs in this directory relate to developing Kubernetes.
 
 * **Development Guide** ([development.md](development.md)): Setting up your environment tests.
 
+* **Making release notes** ([making-release-notes.md](making-release-notes.md)): Generating release nodes for a new release.
+
 * **Hunting flaky tests** ([flaky-tests.md](flaky-tests.md)): We have a goal of 99.9% flake free tests.
   Here's how to run your tests many times.
 
diff --git a/docs/making-release-notes.md b/docs/devel/making-release-notes.md
similarity index 100%
rename from docs/making-release-notes.md
rename to docs/devel/making-release-notes.md
diff --git a/docs/user-guide.md b/docs/user-guide.md
index 7ea10921b6..a3ab0e0c05 100644
--- a/docs/user-guide.md
+++ b/docs/user-guide.md
@@ -58,14 +58,22 @@ kubernetes API, or to contribute directly to the kubernetes project.
 * **Glossary** ([glossary.md](glossary.md)): Terms and concepts.
 
 ## Further reading
-
+<!--- make sure all documents from the docs directory are linked somewhere.
+This one-liner (execute in docs/ dir) prints unlinked documents (only from this
+dir - no recursion):
+for i in *.md; do grep -r $i . | grep -v "^\./$i" > /dev/null; rv=$?; if [[ $rv -ne 0 ]]; then echo $i; fi; done
+-->
 
 * **Annotations** ([annotations.md](annotations.md)): Attaching
   arbitrary non-identifying metadata.
 
+* **Downward API** ([downward_api.md](downward_api.md)): Accessing system
+  configuration from a pod without accessing Kubernetes API (see also
+  [container-environment.md](container-environment.md)).
+
 * **Kubernetes Container Environment** ([container-environment.md](container-environment.md)):
   Describes the environment for Kubelet managed containers on a Kubernetes
-  node.
+  node (see also [downward_api.md](downward_api.md)).
 
 * **DNS Integration with SkyDNS** ([dns.md](dns.md)):
   Resolving a DNS name directly to a Kubernetes service.
@@ -83,6 +91,9 @@ kubernetes API, or to contribute directly to the kubernetes project.
 
 * **Networking** ([networking.md](networking.md)): Pod networking overview.
 
+* **Services and firewalls** ([services-firewalls.md](services-firewalls.md)): How
+  to use firewalls.
+
 * **The Kubernetes Resource Model** ([resources.md](resources.md)):
   Provides resource information such as size, type, and quantity to assist in
   assigning Kubernetes resources appropriately.