From 29bcfd0989d6a12dccaf2ba9c621aabf65839347 Mon Sep 17 00:00:00 2001
From: scriptautomate-bc <204508229+scriptautomate-bc@users.noreply.github.com>
Date: Mon, 13 Jul 2026 15:57:22 -0500
Subject: [PATCH 1/3] Link back to main salt project website

---
 docs/_templates/header-links.html | 1 +
 docs/conf.py                      | 5 ++---
 docs/requirements.txt             | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/_templates/header-links.html b/docs/_templates/header-links.html
index 83c56c2..f1e7d2e 100644
--- a/docs/_templates/header-links.html
+++ b/docs/_templates/header-links.html
@@ -65,6 +65,7 @@
       navbarCenter.innerHTML = "";
 
       const links = [
+        { name: "Home", url: "https://saltproject.io/" },
         { name: "Install Guide", url: "https://docs.saltproject.io/salt/install-guide/en/latest/" },
         { name: "User Guide", url: "https://docs.saltproject.io/salt/user-guide/en/latest/", active: true },
         { name: "Reference Docs", url: "https://docs.saltproject.io/en/latest/contents.html" }
diff --git a/docs/conf.py b/docs/conf.py
index 295a9c0..7c6c7d2 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -135,11 +135,10 @@ def setup(app):
     "genindex.html",
 ]
 
-html_logo = None
+html_logo = "_static/img/SaltProject_altlogo_teal.png"
 html_theme_options = {
     "logo": {
-        "image_light": "_static/img/SaltProject_altlogo_teal.png",
-        "image_dark": "_static/img/SaltProject_altlogo_teal.png",
+        "link": "https://saltproject.io",
     },
     "navbar_start": ["navbar-logo"],
     "navbar_center": ["navbar-nav", "header-links"],
diff --git a/docs/requirements.txt b/docs/requirements.txt
index 628bbcc..1e3d26d 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,5 +1,5 @@
 Sphinx-Substitution-Extensions>=2022.2.16
-pydata-sphinx-theme
+pydata-sphinx-theme==0.20.0
 sphinx-copybutton>=0.5.1
 sphinx-design>=0.3.0
 sphinx-inline-tabs>=2022.1.2b11

From 1aa6732d8ad2c08bb96c8187cdc66275fc73669b Mon Sep 17 00:00:00 2001
From: scriptautomate-bc <204508229+scriptautomate-bc@users.noreply.github.com>
Date: Fri, 17 Jul 2026 14:03:19 -0500
Subject: [PATCH 2/3] Update the left-hand-nav TOC title formatting

---
 docs/_static/css/import-all-salt-docs.css | 28 +++++++++++++++++++++++
 docs/_templates/globaltoc.html            |  4 +++-
 docs/conf.py                              |  2 +-
 3 files changed, 32 insertions(+), 2 deletions(-)

diff --git a/docs/_static/css/import-all-salt-docs.css b/docs/_static/css/import-all-salt-docs.css
index 7a644b6..bd6a385 100644
--- a/docs/_static/css/import-all-salt-docs.css
+++ b/docs/_static/css/import-all-salt-docs.css
@@ -1 +1,29 @@
 @import url("https://saltstack.gitlab.io/open/docs/docs-hub/_static/css/all-salt-docs.css");
+
+/* Custom Sidebar Title Styling */
+h3.salt-nav-title {
+    font-size: 1.125rem !important; /* Adjusts size to match saltproject.io */
+    font-weight: 600 !important;    /* Gives it a slightly bold, clean weight */
+    margin-bottom: 1rem;
+    padding-left: 0;
+}
+
+h3.salt-nav-title a {
+    color: #333333 !important;      /* Dark gray text matching the main site */
+    text-decoration: none !important; /* Removes the underline */
+    box-shadow: none !important;    /* Removes any border-bottom shadows applied by the theme */
+}
+
+h3.salt-nav-title a:hover {
+    color: #00e1cc !important;      /* Salt Project's signature teal on hover */
+    text-decoration: none !important;
+}
+
+/* Custom Sidebar Title Styling - Dark Mode Override */
+html[data-theme="dark"] h3.salt-nav-title a {
+    color: #f8f9fa !important;        /* Light text for dark mode visibility */
+}
+
+html[data-theme="dark"] h3.salt-nav-title a:hover {
+    color: #00e1cc !important;        /* Keeps the teal hover in dark mode */
+}
diff --git a/docs/_templates/globaltoc.html b/docs/_templates/globaltoc.html
index 1b136d2..2b35ee9 100644
--- a/docs/_templates/globaltoc.html
+++ b/docs/_templates/globaltoc.html
@@ -1,4 +1,6 @@
-<h3><a href="{{ pathto(root_doc)|e }}">{{ project|title }}</a></h3>
+<h3 class="salt-nav-title">
+  <a href="{{ pathto(root_doc)|e }}">{{ project|title }}</a>
+</h3>
 <div id="salt-globaltoc">
 {{ toctree(includehidden=True, collapse=False, maxdepth=2) }}
 </div>
diff --git a/docs/conf.py b/docs/conf.py
index 7c6c7d2..985fb9f 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -157,7 +157,7 @@ def setup(app):
 # or fully qualified paths (eg. https://example.com)
 html_css_files = [
     'css/import-all-salt-docs.css',
-    'css/local-testing.css'
+    'css/local-testing.css',
 ]
 
 # The name of an image file (within the static path) to use as favicon of the

From 368e424b87662632956e224623b8393e22bc8df8 Mon Sep 17 00:00:00 2001
From: scriptautomate-bc <204508229+scriptautomate-bc@users.noreply.github.com>
Date: Fri, 17 Jul 2026 16:26:49 -0500
Subject: [PATCH 3/3] Add github, discord, rss icons and links

---
 docs/conf.py | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/docs/conf.py b/docs/conf.py
index 985fb9f..4a8a3fe 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -144,6 +144,26 @@ def setup(app):
     "navbar_center": ["navbar-nav", "header-links"],
     "navbar_end": ["theme-switcher", "navbar-icon-links"],
     "navigation_depth": 4,
+    "icon_links": [
+        {
+            "name": "GitHub",
+            "url": "https://github.com/saltstack/salt-user-guide",
+            "icon": "fa-brands fa-github",
+            "type": "fontawesome",
+        },
+        {
+            "name": "Discord",
+            "url": "https://discord.gg/J7b7EscrAs",
+            "icon": "fa-brands fa-discord",
+            "type": "fontawesome",
+        },
+        {
+            "name": "RSS Feed",
+            "url": "https://saltproject.io/community/rss-feeds/",
+            "icon": "fa-solid fa-rss",
+            "type": "fontawesome",
+        },
+    ],
 }
 
 html_sidebars = {"**": ["globaltoc.html"]}