From 10ba376a99c9b49ec5f62ac82b7408ce4b71f2b4 Mon Sep 17 00:00:00 2001
From: Olivier Gambier <olivier@docker.com>
Date: Sun, 31 May 2015 20:08:28 -0700
Subject: [PATCH] Minor cleanup in the index

- adding glossary
- removing empty "advanced"
- commenting out building and architecture for now
- minor text enhancements

Signed-off-by: Olivier Gambier <olivier@docker.com>
---
 docs/index.md | 23 ++++++++++++++---------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/docs/index.md b/docs/index.md
index 34b3a8b6d..2a7f08f25 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -17,7 +17,7 @@ You should use the Registry if you want to:
 
  * tightly control where your images are being stored
  * fully own your images distribution pipeline
- * integrate images storage and distribution into your inhouse, on premises development workflow
+ * integrate images storage and distribution into your inhouse development workflow
 
 ## Alternatives
 
@@ -27,7 +27,7 @@ Users looking for a commercially supported version of the Registry should look i
 
 ## Requirements
 
-The Registry is compatible with Docker engine version 1.6.0 or higher.
+The Registry is compatible with Docker engine **version 1.6.0 or higher**.
 If you really need to work with older Docker versions, you should look into the [old python registry](https://github.com/docker/docker-registry)
 
 ## TL;DR
@@ -36,16 +36,16 @@ If you really need to work with older Docker versions, you should look into the
 # Start your registry
 docker run -d -p 5000:5000 registry:2
 
-# Pull (or build) some image
+# Pull (or build) some image from the hub
 docker pull ubuntu
 
-# Name the image to point to your registry
+# Tag the image so that it points to your registry
 docker tag ubuntu localhost:5000/myfirstimage
 
 # Push it
 docker push localhost:5000/myfirstimage
 
-# Pull it
+# Pull it back
 docker pull localhost:5000/myfirstimage
 ```
 
@@ -60,14 +60,19 @@ Simple as that? Yes. Now, please read the...
  - [Getting help](help.md)
  - [Contributing](../CONTRIBUTING.md)
 
-Advanced topics:
+### Reference and advanced topics
 
+ - [Glossary](glossary.md)
  - [Authentication](authentication.md)
  - [Working with notifications](notifications.md)
- - [Advanced ops](advanced.md)
 
-Development resources:
+### Development resources
+
  - [Storage driver model](storagedrivers.md)
  - [Registry API](spec/api.md)
+<!--
+ - [Building the registry](building.md)
+ - [Architecture notes](architecture.md)
+ -->
 
-
+ 
\ No newline at end of file