diff --git a/docs/compatibility.md b/docs/compatibility.md
index 9a7bdd42..6ff4c741 100644
--- a/docs/compatibility.md
+++ b/docs/compatibility.md
@@ -1,8 +1,11 @@
 <!--[metadata]>
 +++
-title = "registry Compatibility"
+title = "Compatibility"
 description = "describes get by digest pitfall"
 keywords = ["registry, manifest, images, tags, repository, distribution, digest"]
+[menu.main]
+parent="smn_registry_ref"
+weight=9
 +++
 <![end-metadata]-->
 
@@ -78,4 +81,4 @@ constraints of CAS.*
 For this reason if a manifest is pulled by _digest_ from a registry 2.3 with Docker
 Engine 1.9 and older, and the manifest was pushed with Docker Engine 1.10, a
 security check will cause the Engine to receive a manifest it cannot use and the
-pull will fail.
\ No newline at end of file
+pull will fail.
diff --git a/docs/deprecated.md b/docs/deprecated.md
index 796d3fa5..73bde497 100644
--- a/docs/deprecated.md
+++ b/docs/deprecated.md
@@ -1,8 +1,11 @@
 <!--[metadata]>
 +++
-title = "registry deprecation"
+title = "Deprecated Features"
 description = "describes deprecated functionality"
 keywords = ["registry, manifest, images, signatures, repository, distribution, digest"]
+[menu.main]
+parent="smn_registry_ref"
+weight=8
 +++
 <![end-metadata]-->
 
diff --git a/docs/garbage-collection.md b/docs/garbage-collection.md
index 688bfb25..2d03e787 100644
--- a/docs/garbage-collection.md
+++ b/docs/garbage-collection.md
@@ -3,6 +3,9 @@
 title = "Garbage Collection"
 description = "High level discussion of garbage collection"
 keywords = ["registry, garbage, images, tags, repository, distribution"]
+[menu.main]
+parent="smn_registry_ref"
+weight=4
 +++
 <![end-metadata]-->
 
diff --git a/docs/index.md b/docs/index.md
index 2eb5f767..e8be74e9 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -6,6 +6,7 @@ keywords = ["registry, on-prem, images, tags, repository, distribution"]
 aliases = ["/registry/overview/"]
 [menu.main]
 parent="smn_registry"
+weight=1
 +++
 <![end-metadata]-->
 
diff --git a/docs/insecure.md b/docs/insecure.md
index 88055d51..86d85930 100644
--- a/docs/insecure.md
+++ b/docs/insecure.md
@@ -3,6 +3,9 @@
 title = "Testing an insecure registry"
 description = "Deploying a Registry in an insecure fashion"
 keywords = ["registry, on-prem, images, tags, repository, distribution, insecure"]
+[menu.main]
+parent="smn_registry_ref"
+weight=5
 +++
 <![end-metadata]-->