refactor: replace archived m2r with updated mistune

[dangotbanned]

The dev dependency m2r was archived on 2022-11-17.
The most popular fork m2r2 was last updated on 2023-01-30.

m2r was used to convert markdown to rst, extending https://github.com/lepture/mistune/releases/tag/v0.8.4

This functionality is part of the current version of mistune

mistune==0.8.4 currently raises the following error during doc:built-html:

Run hatch run doc:build-html
Creating environment: doc
Installing project in development mode
Checking dependencies
cmd [1] | mkdir -p doc/_images
cmd [2] | sphinx-build -b html -d doc/_build/doctrees doc doc/_build/html
Running Sphinx v7.4.7
loading translations [en]... done
/home/runner/.local/share/hatch/env/virtual/altair/801ceKDt/doc/lib/python3.12/site-packages/mistune.py:435: SyntaxWarning: invalid escape sequence '\|'
  cells[i][c] = re.sub('\\\\\|', '|', cell)
making output directory... done

---

Changes

Most of the diff is due to m2r inserting whitespace where it wasn't needed.

As a bonus, some bulleted lists that appear within a parameter description are now formatted correctly.

Before -> After

[mattijn]

Thanks! Really nice to read through the commits one by one to follow the proces. And I like the bonus too!

[dangotbanned]

Thanks! Really nice to read through the commits one by one to follow the proces. And I like the bonus too!

Thanks @mattijn

It was an interesting journey to get there, but surprisingly few changes (in tools/) at the end of all the commits