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,5 @@
 sphinx
 sphinx_rtd_theme
-myst_parser
+myst_parser==0.16.1
 -e .
 attrs  # required for myst, but not automatically installed by myst

requirements/docs.txt

@@ -1,10 +1,10 @@
 #
-# 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 .
+-e file:///home/moose/Github/py-pdf/pypdf
     # via -r requirements/docs.in
 alabaster==0.7.13
     # via sphinx
@@ -16,9 +16,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 +41,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 +78,10 @@ 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
+    #   pypdf
 urllib3==1.26.15
     # via requests
 zipp==3.15.0