Merge pull request #2 from gspetro-NOAA/USS-535

Fix Doc CI Fail

Author: selbigmtnwx23

.readthedocs.yaml

@@ -4,10 +4,13 @@
 
 # Required
 version: 2
-build: 
-  os: ubuntu-20.04
-  tools: 
-    python: "3.9"
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.12"
+  jobs:
+    post_create_environment:
+      - python -m pip install --upgrade "pip" "setuptools<81"
 
 # Build documentation in the docs/ directory with Sphinx
 sphinx:

doc/UsersGuide/requirements.in

@@ -1,4 +1,5 @@
-sphinx==7.4.7
-sphinx_rtd_theme
-sphinxcontrib-bibtex
-requests==2.32.2
+sphinx>=8.0.0
+sphinx_rtd_theme>=3.0.0
+sphinxcontrib-bibtex>=2.6.4
+requests>=2.32.2
+setuptools<81.0.0

doc/UsersGuide/requirements.txt

@@ -2,7 +2,7 @@
 # This file is autogenerated by pip-compile with Python 3.13
 # by the following command:
 #
-#    pip-compile requirements.in
+#    pip-compile --allow-unsafe --strip-extras requirements.in
 #
 alabaster==0.7.16
     # via sphinx
@@ -50,17 +50,17 @@ six==1.16.0
     #   pybtex
 snowballstemmer==2.2.0
     # via sphinx
-sphinx==7.4.7
+sphinx==8.0.2
     # via
     #   -r requirements.in
     #   sphinx-rtd-theme
     #   sphinxcontrib-bibtex
     #   sphinxcontrib-jquery
-sphinx-rtd-theme==2.0.0
+sphinx-rtd-theme==3.1.0
     # via -r requirements.in
 sphinxcontrib-applehelp==1.0.8
     # via sphinx
-sphinxcontrib-bibtex==2.6.2
+sphinxcontrib-bibtex==2.6.4
     # via -r requirements.in
 sphinxcontrib-devhelp==1.0.6
     # via sphinx
@@ -76,3 +76,9 @@ sphinxcontrib-serializinghtml==1.1.10
     # via sphinx
 urllib3==2.2.2
     # via requests
+
+# The following packages are considered to be unsafe in a requirements file:
+setuptools==80.10.2
+    # via
+    #   -r requirements.in
+    #   sphinxcontrib-bibtex