Merge branch 'docs/sphinx-myst-ext'

aio-libs · Nov 19, 2023 · f31cb1e · f31cb1e
2 parents a9c00da + 8c2e9a4
commit f31cb1e
Show file tree

Hide file tree

Showing 3 changed files with 6 additions and 1 deletion.
diff --git a/CHANGES/853.contrib.rst b/CHANGES/853.contrib.rst
@@ -0,0 +1,4 @@
+MyST is now integrated in Sphinx -- by :user:`webknjaz`.
+
+This allows the contributors to author new documents in Markdown
+when they have difficulties with going straight RST.
diff --git a/docs/conf.py b/docs/conf.py
@@ -62,6 +62,7 @@
     # Third-party extensions:
     "alabaster",
     "sphinxcontrib.towncrier.ext",  # provides `towncrier-draft-entries` directive
+    "myst_parser",  # extended markdown; https://pypi.org/project/myst-parser/
 ]
 
 
@@ -85,7 +86,6 @@
 # You can specify multiple suffix as a list of string:
 #
 # source_suffix = ['.rst', '.md']
-source_suffix = ".rst"
 
 # The encoding of source files.
 #

diff --git a/requirements/doc.txt b/requirements/doc.txt
@@ -1,2 +1,3 @@
+myst-parser >= 0.10.0
 sphinx==7.0.1
 sphinxcontrib-towncrier