diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml
index 3713fcbd2..e028052d6 100644
--- a/docs/mkdocs.yml
+++ b/docs/mkdocs.yml
@@ -79,12 +79,6 @@ nav:
       - Migrate inventory Services: guides/migrate-inventory-services.md
   - Reference:
       - Overview: reference/index.md
-      - Architecture Decisions:
-          - Architecture Decisions: decisions/README.md
-          - 01-clanModules: decisions/01-ClanModules.md
-          - 02-clan-api: decisions/02-clan-api.md
-          - 03-adr-numbering-process: decisions/03-adr-numbering-process.md
-          - Template: decisions/_template.md
       - Clan Services:
           - reference/clanServices/index.md
           - reference/clanServices/admin.md
@@ -165,6 +159,12 @@ nav:
       - Nix API:
           - buildClan: reference/nix-api/buildclan.md
           - Inventory: reference/nix-api/inventory.md
+      - Decisions:
+          - Architecture Decisions: decisions/README.md
+          - 01-clanModules: decisions/01-ClanModules.md
+          - 02-clan-api: decisions/02-clan-api.md
+          - 03-adr-numbering-process: decisions/03-adr-numbering-process.md
+          - Template: decisions/_template.md
 
 docs_dir: site
 site_dir: out
diff --git a/docs/site/index.md b/docs/site/index.md
index 4ac959d37..e869a5975 100644
--- a/docs/site/index.md
+++ b/docs/site/index.md
@@ -52,23 +52,17 @@ hide:
 
 <div class="grid cards" markdown>
 
--   [Reference Overview](./reference/index.md)
-
-    ---
-
-    Learn how to interface with Clan programmatically
-
 -   [Cli Reference](./reference/cli/index.md)
 
     ---
 
     The `clan` cli command
 
--   [Modules](./reference/clanModules/index.md)
+-   [Service Modules](./reference/clanServices/index.md)
 
     ---
 
-    An overview of available clan modules
+    An overview of available service modules
 
 -   [Core](./reference/clan-core/index.md)
 
@@ -78,5 +72,13 @@ hide:
     This is imported when using clan and is the basis of the extra functionality
     that can be provided.
 
+-   [(Legacy) Modules](./reference/clanModules/index.md)
+
+    ---
+
+    An overview of available clanModules
+
+    !!! Example "Those will get deprecated soon"
+
 
 </div>