DOC: build dev documentation

This PR builds the development documentation with sphinx.
It required moving the existing files from the root directory to the ``doc`` directory.

Author: Kai-Striega

doc/source/conf.py

@@ -33,6 +33,7 @@
     'sphinx.ext.autodoc',
     'numpydoc',
     'sphinx.ext.mathjax',
+    'myst_parser',
 ]
 
 # Add any paths that contain templates here, relative to this directory.

doc_developer/building_with_poetry.md renamed to doc/source/dev/building_with_poetry.md

@@ -65,8 +65,9 @@ Development
 .. toctree::
    :maxdepth: 1
 
-   doc_developer/getting_the_code
-   doc_developer/building_with_poetry
+   dev/getting_the_code.md
+   dev/building_with_poetry.md
+   dev/running_the_benchmarks.md
 
 .. include:: release-notes.rst
 

doc_developer/getting_the_code.md renamed to doc/source/dev/getting_the_code.md

@@ -48,6 +48,7 @@ pytest = "^8.0"
 sphinx = "^7.0"
 numpydoc = "^1.5"
 pydata-sphinx-theme = "^0.14.3"
+myst-parser = "^2.0.0"