diff --git a/registry/content.md b/registry/content.md
index 059fee69c..707186f49 100644
--- a/registry/content.md
+++ b/registry/content.md
@@ -1,15 +1,19 @@
 # Docker Registry
 
-See comprehensive documentation on our [GitHub page](https://github.com/docker/docker-registry).
+The tags >= 2 refer to the [new registry](https://github.com/docker/distribution).
+
+Older tags refer to the [deprecated registry](https://github.com/docker/docker-registry).
 
 ## Run the Registry
 
-### Recommended: run the registry docker container
-
 -	install docker according to the [following instructions](http://docs.docker.io/installation/#installation)
--	run the registry: `docker run -p 5000:5000 registry`
 
-or
+### Run the registry docker container: Quick version
+
+-	run the registry: `docker run -p 5000:5000 -v <HOST_DIR>:/tmp/registry-dev registry`
+-	Modify your docker startup line/script: add "-H tcp://127.0.0.1:2375 -H unix:///var/run/docker.sock --insecure-registry <REGISTRY_HOSTNAME>:5000"
+
+### Recommended: run the registry docker container
 
 	docker run \
 	         -e SETTINGS_FLAVOR=s3 \