Include contributing guidelines in Sphinx docs (#771)

docs/conf.py

@@ -159,6 +159,7 @@
 # -- Options for intersphinx extension ---------------------------------------
 
 intersphinx_mapping = {
+    'myst': ('https://myst-parser.rtfd.io/en/latest', None),
     'python': ('https://docs.python.org/3', None),
     'python2': ('https://docs.python.org/2', None),
 }

docs/contributing/guidelines.md

@@ -0,0 +1,34 @@
+```{spelling}
+de
+facto
+Pre
+reStructuredText
+```
+
+```{include} ../../CONTRIBUTING.md
+```
+
+# Contributing docs
+
+We use [Sphinx] to generate our docs website. You can trigger
+the process locally by executing:
+
+```shell-session
+$ tox -e build-docs
+```
+
+It is also integrated with [Read The Docs] that builds and
+publishes each commit to the main branch and generates live
+docs previews for each pull request.
+
+The sources of the [Sphinx] documents use reStructuredText as a
+de-facto standard. But in order to make contributing docs more
+beginner-friendly, we have integrated [MyST parser] allowing us
+to also accept new documents written in an extended version of
+Markdown that supports using Sphinx directives and roles. {ref}`Read
+the docs <myst:intro/writing>` to learn more on how to use it.
+
+
+[MyST parser]: https://pypi.org/project/myst-parser/
+[Read The Docs]: https://readthedocs.org
+[Sphinx]: https://www.sphinx-doc.org

docs/index.md

@@ -36,6 +36,7 @@ Glossary <glossary>
 :hidden:
 
 Code Of Conduct <contributing/code_of_conduct>
+contributing/guidelines
 contributing/security
 Private unsupported (dev) API autodoc <pkg/modules>
 ```