Update Read the Docs configuration to use Python 3.10 and latest rocm-docs-core (ROCm#194)

* Update Read the Docs configuration to use Python 3.10 and latest rocm-docs-core

* Update doc reqs used by tests

* Update test.yml

Test already installs docs/requirements.txt

* Use python 3.10 and ubuntu 22 in test

* Wrap 3.10 in quotes to avoid interpreting as 3.1

* Revert to ubu20

Author: samjwu

.github/workflows/test.yml

@@ -14,10 +14,10 @@ jobs:
     runs-on: ubuntu-20.04
     steps:
     - uses: actions/checkout@v1
-    - name: Set up Python 3.9
+    - name: Set up Python 3.10
       uses: actions/setup-python@v2
       with:
-        python-version: 3.9
+        python-version: "3.10"
     - name: Install dependencies
       run: |
         python -m pip install --upgrade setuptools pip wheel
@@ -44,10 +44,10 @@ jobs:
 
     steps:
     - uses: actions/checkout@v1
-    - name: Set up Python 3.9
+    - name: Set up Python 3.10
       uses: actions/setup-python@v2
       with:
-        python-version: 3.9
+        python-version: "3.10"
     - name: Setup cmake
       uses: jwlawson/[email protected]
       with:
@@ -57,7 +57,6 @@ jobs:
         python -m pip install --upgrade setuptools pip wheel
         python -m pip install cget ninja
         python -m pip install -r docs/requirements.txt
-        python -m pip install -r test/docsphinx/docs/.sphinx/requirements.txt
     - name: Install Doxygen
       uses: ssciwr/doxygen-install@v1
       with:

.readthedocs.yaml

@@ -15,4 +15,4 @@ python:
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.8"
+    python: "3.10"

docs/requirements.in

@@ -1,2 +1,2 @@
 sphinxcontrib-moderncmakedomain==3.29.0
-rocm-docs-core==0.38.1
+rocm-docs-core==1.4.0

docs/requirements.txt

@@ -1,22 +1,22 @@
 #
-# This file is autogenerated by pip-compile with Python 3.8
+# This file is autogenerated by pip-compile with Python 3.10
 # by the following command:
 #
 #    pip-compile requirements.in
 #
-accessible-pygments==0.0.4
+accessible-pygments==0.0.5
     # via pydata-sphinx-theme
-alabaster==0.7.13
+alabaster==0.7.16
     # via sphinx
-babel==2.14.0
+babel==2.15.0
     # via
     #   pydata-sphinx-theme
     #   sphinx
 beautifulsoup4==4.12.3
     # via pydata-sphinx-theme
 breathe==4.35.0
     # via rocm-docs-core
-certifi==2023.11.17
+certifi==2024.6.2
     # via requests
 cffi==1.16.0
     # via
@@ -26,11 +26,11 @@ charset-normalizer==3.3.2
     # via requests
 click==8.1.7
     # via sphinx-external-toc
-cryptography==41.0.7
+cryptography==42.0.8
     # via pyjwt
 deprecated==1.2.14
     # via pygithub
-docutils==0.19
+docutils==0.21.2
     # via
     #   breathe
     #   myst-parser
@@ -40,41 +40,41 @@ fastjsonschema==2.19.1
     # via rocm-docs-core
 gitdb==4.0.11
     # via gitpython
-gitpython==3.1.41
+gitpython==3.1.43
     # via rocm-docs-core
-idna==3.6
+idna==3.7
     # via requests
 imagesize==1.4.1
     # via sphinx
-jinja2==3.1.3
+jinja2==3.1.4
     # via
     #   myst-parser
     #   sphinx
-markdown-it-py==2.2.0
+markdown-it-py==3.0.0
     # via
     #   mdit-py-plugins
     #   myst-parser
-markupsafe==2.1.3
+markupsafe==2.1.5
     # via jinja2
-mdit-py-plugins==0.3.5
+mdit-py-plugins==0.4.1
     # via myst-parser
 mdurl==0.1.2
     # via markdown-it-py
-myst-parser==1.0.0
+myst-parser==3.0.1
     # via rocm-docs-core
-packaging==23.2
+packaging==24.0
     # via
     #   pydata-sphinx-theme
     #   sphinx
-pycparser==2.21
+pycparser==2.22
     # via cffi
-pydata-sphinx-theme==0.14.4
+pydata-sphinx-theme==0.15.3
     # via
     #   rocm-docs-core
     #   sphinx-book-theme
-pygithub==2.1.1
+pygithub==2.3.0
     # via rocm-docs-core
-pygments==2.17.2
+pygments==2.18.0
     # via
     #   accessible-pygments
     #   pydata-sphinx-theme
@@ -83,28 +83,24 @@ pyjwt[crypto]==2.8.0
     # via pygithub
 pynacl==1.5.0
     # via pygithub
-python-dateutil==2.8.2
-    # via pygithub
 pyyaml==6.0.1
     # via
     #   myst-parser
     #   rocm-docs-core
     #   sphinx-external-toc
-requests==2.31.0
+requests==2.32.3
     # via
     #   pygithub
     #   sphinx
-rocm-docs-core==0.38.1
+rocm-docs-core==1.4.0
     # via -r requirements.in
-six==1.16.0
-    # via python-dateutil
 smmap==5.0.1
     # via gitdb
 snowballstemmer==2.2.0
     # via sphinx
 soupsieve==2.5
     # via beautifulsoup4
-sphinx==5.3.0
+sphinx==7.3.7
     # via
     #   breathe
     #   myst-parser
@@ -116,35 +112,37 @@ sphinx==5.3.0
     #   sphinx-external-toc
     #   sphinx-notfound-page
     #   sphinxcontrib-moderncmakedomain
-sphinx-book-theme==1.0.1
+sphinx-book-theme==1.1.2
     # via rocm-docs-core
 sphinx-copybutton==0.5.2
     # via rocm-docs-core
-sphinx-design==0.5.0
+sphinx-design==0.6.0
     # via rocm-docs-core
-sphinx-external-toc==0.3.1
+sphinx-external-toc==1.0.1
     # via rocm-docs-core
-sphinx-notfound-page==1.0.0
+sphinx-notfound-page==1.0.2
     # via rocm-docs-core
-sphinxcontrib-applehelp==1.0.4
+sphinxcontrib-applehelp==1.0.8
     # via sphinx
-sphinxcontrib-devhelp==1.0.2
+sphinxcontrib-devhelp==1.0.6
     # via sphinx
-sphinxcontrib-htmlhelp==2.0.1
+sphinxcontrib-htmlhelp==2.0.5
     # via sphinx
 sphinxcontrib-jsmath==1.0.1
     # via sphinx
 sphinxcontrib-moderncmakedomain==3.29.0
     # via -r requirements.in
-sphinxcontrib-qthelp==1.0.3
+sphinxcontrib-qthelp==1.0.7
+    # via sphinx
+sphinxcontrib-serializinghtml==1.1.10
     # via sphinx
-sphinxcontrib-serializinghtml==1.1.5
+tomli==2.0.1
     # via sphinx
-typing-extensions==4.9.0
+typing-extensions==4.12.2
     # via
     #   pydata-sphinx-theme
     #   pygithub
-urllib3==2.1.0
+urllib3==2.2.1
     # via
     #   pygithub
     #   requests

test/docsphinx/docs/.sphinx/requirements.in

@@ -1 +1,2 @@
-rocm-docs-core==0.20.0
+sphinxcontrib-moderncmakedomain==3.29.0
+rocm-docs-core==1.4.0