From 749ff049d3979103687dea9dcbe0d476ee222b76 Mon Sep 17 00:00:00 2001
From: Hung Do <nguyenhung_do@hotmail.com>
Date: Wed, 6 Aug 2025 16:51:32 -0400
Subject: [PATCH 1/5] Removed changes

---
 doc/source/conf.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/doc/source/conf.py b/doc/source/conf.py
index f222a228531ff..d7f9f42f2c3ef 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -796,7 +796,6 @@ def rstjinja(app, docname, source) -> None:
     rendered = app.builder.templates.render_string(src, app.config.html_context)
     source[0] = rendered
 
-
 def setup(app) -> None:
     app.connect("source-read", rstjinja)
     app.connect("autodoc-process-docstring", remove_flags_docstring)

From a5dfbe1f1c4061366b3419d6b37766befbc7c769 Mon Sep 17 00:00:00 2001
From: Hung Do <nguyenhung_do@hotmail.com>
Date: Wed, 6 Aug 2025 20:59:10 -0400
Subject: [PATCH 2/5] Added comments to test

---
 doc/_templates/sidebar-nav-bs.html | 42 ++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/doc/_templates/sidebar-nav-bs.html b/doc/_templates/sidebar-nav-bs.html
index 8298b66568e20..03c4266bc6296 100644
--- a/doc/_templates/sidebar-nav-bs.html
+++ b/doc/_templates/sidebar-nav-bs.html
@@ -5,5 +5,47 @@
     {% else %}
     {{ generate_toctree_html("sidebar", maxdepth=4, collapse=False, includehidden=True, titles_only=True) }}
     {% endif %}
+
+    <!-- {% if pagename.startswith("reference") %}
+      {% set toc = generate_toctree_html(
+        "sidebar",
+        maxdepth=4,
+        collapse=True,
+        includehidden=True,
+        titles_only=True
+      ) %}
+      {% set toc_items = toc.split('<li>') %}
+      {% set sorted_items = ['<li>' + item for item in toc_items[1:]|sort(case_sensitive=False)] %}
+      {{ sorted_items|join('')|safe }}
+    {% else %}
+      {{ generate_toctree_html("sidebar", maxdepth=4, collapse=False, includehidden=True, titles_only=True) }}
+    {% endif %} -->
+
+    <!-- {% if pagename.startswith("reference") %}
+      {% set toc = generate_toctree_html(
+        "sidebar",
+        maxdepth=4,
+        collapse=True,
+        includehidden=True,
+        titles_only=True
+      ) %}
+      {% set toc_items = toc.split('<li>') %}
+      {% set sorted_items = ['<li>' + item for item in toc_items[1:]|sort(case_sensitive=False)] %}
+      <div class="bd-toc-item navbar-nav">
+        {{ sorted_items|join('')|safe }}
+      </div>
+    {% else %}
+      {{ generate_toctree_html("sidebar", maxdepth=4, collapse=False, includehidden=True, titles_only=True) }}
+    {% endif %} -->
+
+    <!-- {% if pagename.startswith("reference") %}
+      {% set toc = generate_toctree_html("sidebar", maxdepth=4, collapse=True, includehidden=True, titles_only=True) %}
+      {% set items = toc.split('</li>') %}
+      {% for item in items|sort(case_sensitive=False) %}
+        {{ item }}</li>
+      {% endfor %}
+    {% else %}
+      {{ generate_toctree_html("sidebar", maxdepth=4, collapse=False, includehidden=True, titles_only=True) }}
+    {% endif %} -->
   </div>
 </nav>

From 65cd394e78a1e18003fcd1e96df745ba26563cb1 Mon Sep 17 00:00:00 2001
From: Hung Do <nguyenhung_do@hotmail.com>
Date: Thu, 7 Aug 2025 18:31:17 -0400
Subject: [PATCH 3/5] Sorted items in the sidebar (including sections)

---
 doc/_templates/sidebar-nav-bs.html | 68 ++++++++++++------------------
 1 file changed, 26 insertions(+), 42 deletions(-)

diff --git a/doc/_templates/sidebar-nav-bs.html b/doc/_templates/sidebar-nav-bs.html
index 03c4266bc6296..e27ca12f59980 100644
--- a/doc/_templates/sidebar-nav-bs.html
+++ b/doc/_templates/sidebar-nav-bs.html
@@ -5,47 +5,31 @@
     {% else %}
     {{ generate_toctree_html("sidebar", maxdepth=4, collapse=False, includehidden=True, titles_only=True) }}
     {% endif %}
-
-    <!-- {% if pagename.startswith("reference") %}
-      {% set toc = generate_toctree_html(
-        "sidebar",
-        maxdepth=4,
-        collapse=True,
-        includehidden=True,
-        titles_only=True
-      ) %}
-      {% set toc_items = toc.split('<li>') %}
-      {% set sorted_items = ['<li>' + item for item in toc_items[1:]|sort(case_sensitive=False)] %}
-      {{ sorted_items|join('')|safe }}
-    {% else %}
-      {{ generate_toctree_html("sidebar", maxdepth=4, collapse=False, includehidden=True, titles_only=True) }}
-    {% endif %} -->
-
-    <!-- {% if pagename.startswith("reference") %}
-      {% set toc = generate_toctree_html(
-        "sidebar",
-        maxdepth=4,
-        collapse=True,
-        includehidden=True,
-        titles_only=True
-      ) %}
-      {% set toc_items = toc.split('<li>') %}
-      {% set sorted_items = ['<li>' + item for item in toc_items[1:]|sort(case_sensitive=False)] %}
-      <div class="bd-toc-item navbar-nav">
-        {{ sorted_items|join('')|safe }}
-      </div>
-    {% else %}
-      {{ generate_toctree_html("sidebar", maxdepth=4, collapse=False, includehidden=True, titles_only=True) }}
-    {% endif %} -->
-
-    <!-- {% if pagename.startswith("reference") %}
-      {% set toc = generate_toctree_html("sidebar", maxdepth=4, collapse=True, includehidden=True, titles_only=True) %}
-      {% set items = toc.split('</li>') %}
-      {% for item in items|sort(case_sensitive=False) %}
-        {{ item }}</li>
-      {% endfor %}
-    {% else %}
-      {{ generate_toctree_html("sidebar", maxdepth=4, collapse=False, includehidden=True, titles_only=True) }}
-    {% endif %} -->
   </div>
 </nav>
+
+<script>
+document.addEventListener('DOMContentLoaded', function() {
+  // Only sort on reference pages
+  if (window.location.pathname.includes('/reference/')) {
+    const navContainer = document.querySelector('#bd-docs-nav .bd-toc-item');
+    if (navContainer) {
+      const lists = navContainer.querySelectorAll('ul');
+      
+      lists.forEach(list => {
+        const items = Array.from(list.children);
+        
+        // Sort items alphabetically
+        items.sort((a, b) => {
+          const textA = a.textContent.trim().toLowerCase();
+          const textB = b.textContent.trim().toLowerCase();
+          return textA.localeCompare(textB);
+        });
+        
+        // Reattach sorted items
+        items.forEach(item => list.appendChild(item));
+      });
+    }
+  }
+});
+</script>
\ No newline at end of file

From 3091cb5d18b5b8e99b94b3e01f8a42ba11b83e07 Mon Sep 17 00:00:00 2001
From: Hung Do <nguyenhung_do@hotmail.com>
Date: Thu, 7 Aug 2025 22:14:53 -0400
Subject: [PATCH 4/5] Made changes so that only the items get sorted

---
 doc/_templates/sidebar-nav-bs.html | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/doc/_templates/sidebar-nav-bs.html b/doc/_templates/sidebar-nav-bs.html
index e27ca12f59980..ca11bc2495136 100644
--- a/doc/_templates/sidebar-nav-bs.html
+++ b/doc/_templates/sidebar-nav-bs.html
@@ -10,24 +10,24 @@
 
 <script>
 document.addEventListener('DOMContentLoaded', function() {
-  // Only sort on reference pages
   if (window.location.pathname.includes('/reference/')) {
     const navContainer = document.querySelector('#bd-docs-nav .bd-toc-item');
     if (navContainer) {
-      const lists = navContainer.querySelectorAll('ul');
+      const topLevelItems = Array.from(navContainer.children);
       
-      lists.forEach(list => {
-        const items = Array.from(list.children);
-        
-        // Sort items alphabetically
-        items.sort((a, b) => {
-          const textA = a.textContent.trim().toLowerCase();
-          const textB = b.textContent.trim().toLowerCase();
-          return textA.localeCompare(textB);
+      topLevelItems.forEach(section => {
+        const subLists = section.querySelectorAll('ul');
+        subLists.forEach(list => {
+          const items = Array.from(list.children);
+          
+          items.sort((a, b) => {
+            const textA = a.textContent.trim().toLowerCase();
+            const textB = b.textContent.trim().toLowerCase();
+            return textA.localeCompare(textB);
+          });
+          
+          items.forEach(item => list.appendChild(item));
         });
-        
-        // Reattach sorted items
-        items.forEach(item => list.appendChild(item));
       });
     }
   }

From 8e414728df8737dc464bbab1864af48dc93e1a8c Mon Sep 17 00:00:00 2001
From: Hung Do <nguyenhung_do@hotmail.com>
Date: Thu, 7 Aug 2025 22:17:24 -0400
Subject: [PATCH 5/5] Synced conf.py

---
 doc/source/conf.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/doc/source/conf.py b/doc/source/conf.py
index d7f9f42f2c3ef..f222a228531ff 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -796,6 +796,7 @@ def rstjinja(app, docname, source) -> None:
     rendered = app.builder.templates.render_string(src, app.config.html_context)
     source[0] = rendered
 
+
 def setup(app) -> None:
     app.connect("source-read", rstjinja)
     app.connect("autodoc-process-docstring", remove_flags_docstring)