Update Python packages for ReadTheDocs builds

.readthedocs.yaml
- Now request Python 3.12 for ReadTheDocs builds

docs/requirements.txt
- Update to more recent Python package versions for ReadTheDocs builds

CHANGELOG.md
- Updated accordingly

Signed-off-by: Bob Yantosca <[email protected]>

Author: yantosca

.readthedocs.yaml

@@ -14,7 +14,7 @@ version: 2
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.7"
+    python: "3.12"
     nodejs: "14"
     rust:   "1.55"
     golang: "1.17"

CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased] - TBD
+### Changed
+- Updated Python package versions for ReadTheDocs in `docs/requirements.txt`
+- Now request Python 3.12 for ReadTheDocs builds in
+  `.readthedocs.yaml`
+
 ## [3.8.0] - 2024-02-07
 ### Changed
 - Updated TOMAS_Jeagle sea salt extension

docs/requirements.txt

@@ -1,16 +1,15 @@
-# Requirements for building the HEMCO documentation
+# ======================================================================
+# ReadTheDocs requirements file
 #
-# NOTE: Use specific versions for Python packages instead of upper
-# bounds.  Using an upper bound will not necessarily install the
-# intended version if there already is a version that meets the
-# criteria present in the Python environment.
-#  -- Bob Yantosca and Lizzie Lundgren (30 Jun 2022)
+# If you wish to install the dependencies for building the ReadTheDocs
+# ReadTheDocs documentation from PyPI (the Python Package Index), use:
 #
-# The following package versions have been proven to work together:
-#
-sphinx==3.5.4
-sphinx_rtd_theme==0.5.2
-sphinxcontrib-bibtex==2.2.0
-recommonmark
-docutils==0.16
-jinja2==3.0.3
+# $ pip install -r requirements.txt
+# ======================================================================
+sphinx==7.2.6
+sphinx_rtd_theme==2.0.0
+sphinxcontrib-bibtex==2.6.2
+sphinx-autobuild==2021.3.14
+recommonmark==0.7.1
+docutils==0.20.1
+jinja2==3.1.3