From eda24cd4bca7e782e55258c26137a35e3f54c838 Mon Sep 17 00:00:00 2001
From: Michael Zingale <michael.zingale@stonybrook.edu>
Date: Thu, 5 Feb 2026 08:29:24 -0500
Subject: [PATCH] address docs accessibility issues fix color contrast add back
 link underlining

---
 Docs/source/_static/theme_overrides.css | 25 +++++++++++++++++++++++--
 Docs/source/conf.py                     |  1 +
 requirements.txt                        |  3 +++
 3 files changed, 27 insertions(+), 2 deletions(-)

diff --git a/Docs/source/_static/theme_overrides.css b/Docs/source/_static/theme_overrides.css
index 51ecd84ce3..dceddeb78c 100644
--- a/Docs/source/_static/theme_overrides.css
+++ b/Docs/source/_static/theme_overrides.css
@@ -34,7 +34,7 @@ div#example-notebook div.highlight-default div.highlight {
 
 .wy-side-nav-search>div.branch{
     font-weight:normal;
-    color:rgba(255,255,255,0.3);
+    color:rgba(255,255,255);
     font-size:100%;
     display:inline-block;
     padding:4px 6px;
@@ -47,4 +47,25 @@ div#example-notebook div.highlight-default div.highlight {
     margin-bottom:.809em; */
     color:#fcfcfc;
     font-weight:bold;
-}
\ No newline at end of file
+}
+
+/* Underline links everywhere */
+.wy-nav-content a {
+    text-decoration: underline;
+    text-decoration-style: dotted;
+    text-underline-offset: 0.15em;
+}
+
+/* Left sidebar navigation links */
+.wy-menu a {
+    text-decoration-line: underline;
+    text-decoration-style: dotted;
+    text-underline-offset: 0.15em;
+}
+
+.wy-side-nav-search a {
+    text-decoration-line: underline;
+    text-decoration-style: dotted;
+    text-underline-offset: 0.15em;
+}
+
diff --git a/Docs/source/conf.py b/Docs/source/conf.py
index abf8ce06c6..31c6204888 100644
--- a/Docs/source/conf.py
+++ b/Docs/source/conf.py
@@ -60,6 +60,7 @@ def get_version():
               'sphinx_copybutton',
               'sphinx_prompt',
               'breathe',
+              'sphinx_rtd_theme_ext_color_contrast',
               'IPython.sphinxext.ipython_console_highlighting']
 
 # bibtex
diff --git a/requirements.txt b/requirements.txt
index 7f8114572a..c27396373b 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -13,3 +13,6 @@ sphinx-prompt
 codespell
 sphinx-math-dollar
 sphinx-copybutton
+
+# for accessibility
+sphinx-rtd-theme-ext-color-contrast