DOC: Add readthedocs.yml and bump docs dependencies using tox -e deps (#1750)

Author: adehad

readthedocs.yml

@@ -0,0 +1,14 @@
+---
+version: 2
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+formats: all
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.10"
+
+python:
+  install:
+    - requirements: requirements/docs.txt

requirements/docs.in

@@ -1,5 +1,5 @@
 sphinx
 sphinx_rtd_theme
-myst_parser==0.16.1
+myst_parser
 -e .
 attrs  # required for myst, but not automatically installed by myst

requirements/docs.txt

@@ -1,22 +1,24 @@
 #
-# This file is autogenerated by pip-compile with Python 3.7
-# by the following command:
+# This file is autogenerated by pip-compile with python 3.6
+# To update, run:
 #
-#    pip-compile requirements/docs.in
+#    pip-compile --output-file=requirements/docs.txt requirements/docs.in
 #
 -e .
     # via -r requirements/docs.in
 alabaster==0.7.13
     # via sphinx
 attrs==22.2.0
     # via -r requirements/docs.in
-babel==2.11.0
+babel==2.12.1
     # via sphinx
 certifi==2022.12.7
     # via requests
-charset-normalizer==3.0.1
+charset-normalizer==3.1.0
     # via requests
-docutils==0.17.1
+colorama==0.4.6
+    # via sphinx
+docutils==0.18.1
     # via
     #   myst-parser
     #   sphinx
@@ -25,61 +27,59 @@ idna==3.4
     # via requests
 imagesize==1.4.1
     # via sphinx
-importlib-metadata==6.0.0
+importlib-metadata==6.1.0
     # via sphinx
 jinja2==3.1.2
     # via
     #   myst-parser
     #   sphinx
-markdown-it-py==2.1.0
+markdown-it-py==2.2.0
     # via
     #   mdit-py-plugins
     #   myst-parser
 markupsafe==2.1.2
     # via jinja2
-mdit-py-plugins==0.3.3
+mdit-py-plugins==0.3.5
     # via myst-parser
 mdurl==0.1.2
     # via markdown-it-py
-myst-parser==0.16.1
+myst-parser==1.0.0
     # via -r requirements/docs.in
 packaging==23.0
     # via sphinx
 pygments==2.14.0
     # via sphinx
-pytz==2022.7.1
-    # via babel
 pyyaml==6.0
     # via myst-parser
 requests==2.28.2
     # via sphinx
 snowballstemmer==2.2.0
     # via sphinx
-sphinx==4.5.0
+sphinx==6.1.3
     # via
     #   -r requirements/docs.in
     #   myst-parser
     #   sphinx-rtd-theme
-sphinx-rtd-theme==1.1.1
+    #   sphinxcontrib-jquery
+sphinx-rtd-theme==1.2.0
     # via -r requirements/docs.in
-sphinxcontrib-applehelp==1.0.2
+sphinxcontrib-applehelp==1.0.4
     # via sphinx
 sphinxcontrib-devhelp==1.0.2
     # via sphinx
-sphinxcontrib-htmlhelp==2.0.0
+sphinxcontrib-htmlhelp==2.0.1
     # via sphinx
+sphinxcontrib-jquery==4.1
+    # via sphinx-rtd-theme
 sphinxcontrib-jsmath==1.0.1
     # via sphinx
 sphinxcontrib-qthelp==1.0.3
     # via sphinx
 sphinxcontrib-serializinghtml==1.1.5
     # via sphinx
-typing-extensions==4.4.0
-    # via
-    #   importlib-metadata
-    #   markdown-it-py
-    #   pypdf
-urllib3==1.26.14
+typing-extensions==4.5.0
+    # via pypdf
+urllib3==1.26.15
     # via requests
-zipp==3.11.0
+zipp==3.15.0
     # via importlib-metadata