From 8fff53df7afddedc938ff91e6d10e762499a9bff Mon Sep 17 00:00:00 2001
From: Michael Benavidez <michael.benavidez@amd.com>
Date: Fri, 26 Jun 2026 08:38:44 -0500
Subject: [PATCH] feature: customizations for cluster.md

---
 docs/conf.py                 | 30 ++++++++++++++++++++++++++++++
 docs/sphinx/_toc.yml.in      |  2 ++
 docs/system-admin/cluster.md |  2 +-
 3 files changed, 33 insertions(+), 1 deletion(-)

diff --git a/docs/conf.py b/docs/conf.py
index fe33b56..d75bfe2 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -266,6 +266,36 @@ def generate_combined_markdown(app, exception):
         encoding="utf-8",
     )
 
+# Pages (by docname) whose primary (left) sidebar should be collapsed by default.
+# #pst-primary-sidebar-checkbox restores the sidebar.
+
+COLLAPSE_PRIMARY_SIDEBAR = {"system-admin/cluster"}
+
+_COLLAPSE_SIDEBAR_STYLE = """
+<style id="default-collapsed-primary-sidebar">
+  html .bd-container .bd-sidebar-primary {
+    margin-left: -20%;
+    opacity: 0;
+    visibility: hidden;
+  }
+  html body #pst-primary-sidebar-checkbox:checked ~ .bd-container .bd-sidebar-primary {
+    margin-left: 0;
+    opacity: 1;
+    visibility: visible;
+  }
+  html body .prev-next-footer {
+    display: none;
+  }
+</style>
+"""
+
+
+def collapse_primary_sidebar(app, pagename, templatename, context, doctree):
+    if pagename in COLLAPSE_PRIMARY_SIDEBAR:
+        context["metatags"] = context.get("metatags", "") + _COLLAPSE_SIDEBAR_STYLE
+
+
 def setup(app):
     app.add_css_file("css/index.css")
+    app.connect("html-page-context", collapse_primary_sidebar)
     app.connect("build-finished", generate_combined_markdown)
diff --git a/docs/sphinx/_toc.yml.in b/docs/sphinx/_toc.yml.in
index d9f9fc0..54af3be 100644
--- a/docs/sphinx/_toc.yml.in
+++ b/docs/sphinx/_toc.yml.in
@@ -95,6 +95,8 @@ subtrees:
             title: Instinct Customer Acceptance Guide
           - url: https://instinct.docs.amd.com/projects/gpu-cluster-networking/en/latest/
             title: Networking
+          - url: https://instinct.docs.amd.com/projects/MI3XX-reference/latest/overview.html
+            title: MI3XX Reference Design
     - file: system-admin/cloud.md
       title: Cloud
       subtrees:
diff --git a/docs/system-admin/cluster.md b/docs/system-admin/cluster.md
index 086207d..acbab75 100644
--- a/docs/system-admin/cluster.md
+++ b/docs/system-admin/cluster.md
@@ -1,4 +1,4 @@
-# Cluster
+# Cluster Networking and Design Hub
 
 ## System and Design Guides