find and replace fixes, will introduce errors

docs/development/aa_core/documentation.md

@@ -4,13 +4,13 @@ The documentation for Alliance Auth uses [Sphinx](http://www.sphinx-doc.org/) to
 to specific branches is made (master, primarily), the repository is automatically pulled, docs built and deployed on
 [readthedocs.org](https://readthedocs.org/).
 
-
 Documentation was migrated from the GitHub wiki pages and into the repository to allow documentation changes to be
 included with pull requests. This means that documentation can be guaranteed to be updated when a pull request is
 accepted rather than hoping documentation is updated afterwards or relying on maintainers to do the work. It also
 allows for documentation to be maintained at different versions more easily.
 
 ## Building Documentation
+
 If you're developing new documentation, its likely you'll want or need to test build it before committing to your
 branch. To achieve this you can use Sphinx to build the documentation locally as it appears on Read the Docs.
 
@@ -24,15 +24,16 @@ build in the `/docs/_build/` directory.
 Occasionally you may need to fully rebuild the documents by running `make clean` first, usually when you add or
 rearrange toctrees.
 
-
 ## Documentation Format
 
-CommonMark Markdown is the current preferred format, via [recommonmark](https://github.com/rtfd/recommonmark).
-reStructuredText is supported if required, or you can execute snippets of reST inside Markdown by using a code block:
+CommonMark-plus Markdown is the current preferred format, via [MyST-Parser](https://github.com/executablebooks/MyST-Parser).
+reStructuredText is supported if required, or you can execute snippets of MyST inside Markdown by using a code block:
 
-    ```eval_rst
-    reStructuredText here
-    ```
+````md
+```{eval-rst}
+reStructuredText here
+```
+````
 
 Markdown is used elsewhere on Github so it provides the most portability of documentation from Issues and Pull Requests
 as well as providing an easier initial migration path from the Github wiki.

docs/development/aa_core/index.md

@@ -2,10 +2,9 @@
 
 This section contains important information on how to develop Alliance Auth itself.
 
-```eval_rst
-.. toctree::
-    :maxdepth: 1
+```{toctree}
+:maxdepth: 1
 
-    documentation
-    code-style
+documentation
+code-style
 ```