DOC: Pin myst_parser==0.16.1 and rename .readthedocs.yaml

myst_parser is pinned to that version as links are otherwise broken,
see #1569

Causing-commit: 0476799

.readthedocs.yaml

@@ -0,0 +1,24 @@
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+version: 2
+
+
+build:
+ os: ubuntu-22.04
+ tools:
+ python: "3.11"
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+ configuration: docs/conf.py
+
+# If using Sphinx, optionally build your docs in additional formats such as PDF
+formats: all
+
+# Optionally declare the Python requirements required to build your docs
+python:
+ install:
+ - requirements: requirements/docs.txt
+ - method: pip
+ path: .
+ extra_requirements:
+ - full

requirements/docs.in

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

requirements/docs.txt

@@ -1,11 +1,9 @@
 #
-# This file is autogenerated by pip-compile with python 3.6
-# To update, run:
+# This file is autogenerated by pip-compile with Python 3.7
+# by the following command:
 #
-# pip-compile --output-file=requirements/docs.txt requirements/docs.in
+# pip-compile requirements/docs.in
 #
--e .
- # via -r requirements/docs.in
 alabaster==0.7.13
  # via sphinx
 attrs==22.2.0
@@ -16,9 +14,7 @@ certifi==2022.12.7
  # via requests
 charset-normalizer==3.1.0
  # via requests
-colorama==0.4.6
- # via sphinx
-docutils==0.18.1
+docutils==0.17.1
  # via
  # myst-parser
  # sphinx
@@ -43,31 +39,33 @@ mdit-py-plugins==0.3.5
  # via myst-parser
 mdurl==0.1.2
  # via markdown-it-py
-myst-parser==1.0.0
+myst-parser==0.16.1
  # via -r requirements/docs.in
 packaging==23.0
  # via sphinx
 pygments==2.14.0
  # via sphinx
+pytz==2023.2
+ # via babel
 pyyaml==6.0
  # via myst-parser
 requests==2.28.2
  # via sphinx
 snowballstemmer==2.2.0
  # via sphinx
-sphinx==6.1.3
+sphinx==4.5.0
  # via
  # -r requirements/docs.in
  # myst-parser
  # sphinx-rtd-theme
  # sphinxcontrib-jquery
 sphinx-rtd-theme==1.2.0
  # via -r requirements/docs.in
-sphinxcontrib-applehelp==1.0.4
+sphinxcontrib-applehelp==1.0.2
  # via sphinx
 sphinxcontrib-devhelp==1.0.2
  # via sphinx
-sphinxcontrib-htmlhelp==2.0.1
+sphinxcontrib-htmlhelp==2.0.0
  # via sphinx
 sphinxcontrib-jquery==4.1
  # via sphinx-rtd-theme
@@ -78,7 +76,9 @@ sphinxcontrib-qthelp==1.0.3
 sphinxcontrib-serializinghtml==1.1.5
  # via sphinx
 typing-extensions==4.5.0
- # via pypdf
+ # via
+ # importlib-metadata
+ # markdown-it-py
 urllib3==1.26.15
  # via requests
 zipp==3.15.0