diff --git a/docs/Dockerfile b/docs/Dockerfile
index f4fcd127..89ee3d29 100644
--- a/docs/Dockerfile
+++ b/docs/Dockerfile
@@ -7,7 +7,7 @@ RUN svn checkout https://github.com/docker/machine/trunk/docs /docs/content/mach
 RUN svn checkout https://github.com/docker/distribution/trunk/docs /docs/content/registry
 RUN svn checkout https://github.com/kitematic/kitematic/trunk/docs /docs/content/kitematic
 RUN svn checkout https://github.com/docker/tutorials/trunk/docs /docs/content/tutorials
-RUN svn checkout https://github.com/docker/opensource/trunk/docs /docs/content
+RUN svn checkout https://github.com/docker/opensource/trunk/docs /docs/content/opensource
 
 ENV PROJECT=registry
 
diff --git a/docs/help.md b/docs/help.md
index 84cda8da..c6ac7ad9 100644
--- a/docs/help.md
+++ b/docs/help.md
@@ -21,4 +21,4 @@ If you want to report a bug:
 - be sure to first read about [how to contribute](https://github.com/docker/distribution/blob/master/CONTRIBUTING.md)
 - you can then do so on the [GitHub project bugtracker](https://github.com/docker/distribution/issues)
 
-You can also find out more about the Docker's project [Getting Help resources](https://docs.docker.com/project/get-help).
+You can also find out more about the Docker's project [Getting Help resources](https://docs.docker.com/opensource/get-help/).
diff --git a/docs/spec/api.md b/docs/spec/api.md
index 320d752f..afbe3762 100644
--- a/docs/spec/api.md
+++ b/docs/spec/api.md
@@ -3,6 +3,7 @@
 title = "HTTP API V2"
 description = "Specification for the Registry API."
 keywords = ["registry, on-prem, images, tags, repository, distribution, api, advanced"]
+aliases = ["/registry/spec/"]
 [menu.main]
 parent="smn_registry_ref"
 +++
diff --git a/docs/spec/auth/index.md b/docs/spec/auth/index.md
new file mode 100644
index 00000000..b0d31256
--- /dev/null
+++ b/docs/spec/auth/index.md
@@ -0,0 +1,14 @@
+<!--[metadata]>
++++
+title = "Docker Regidtry Token Authentication"
+description = "Docker Registry v2 authentication schema"
+keywords = ["registry, on-prem, images, tags, repository, distribution, authentication, advanced"]
+[menu.main]
+parent="smn_registry_ref"
++++
+<![end-metadata]-->
+
+# Docker Registry v2 authentication
+
+See the [Token Authentication Specification](token.md) and
+[Token Authentication Implementation](jwt.md) for more information.
diff --git a/docs/storagedrivers.md b/docs/storagedrivers.md
index c815e668..158ad999 100644
--- a/docs/storagedrivers.md
+++ b/docs/storagedrivers.md
@@ -3,6 +3,7 @@
 title = "Storage Drivers"
 description = "Explains how to use storage drivers"
 keywords = ["registry, on-prem, images, tags, repository, distribution, storage drivers, advanced"]
+aliases = ["/registry/storage-drivers/"]
 [menu.main]
 parent="smn_registry_ref"
 +++