docs(notebooks): restructure notebook based docs

[tachyonicClock]

This is a few changes:

• Replace .ipynb with an alternative notebook format that looks more like plain python (jupytext py:percent). We no longer commit images, tables, etc to the repository. This makes reading diffs easier and lets agents write/read notebooks better.

• Should fix this:

• The "documentation" jobs now run the notebooks rather than the "tests" job.

• We have the capability to link User Guide documentation to API documentation easier.

• The on release action will build the full notebooks but the on pull requests action will use the fast mock data. The build artifact for pull requests will generate the result for the fast mock data.

• Organized the "Tutorials" into a "User Guide" with research domain based sections. I believe we will produce better documentation faster with this structure.

• Each domain has a basic stub with the relevant notebooks integrated. Some notebooks have been split into multiple parts.

Future Work

• Some notebooks outputs look worse. The change switched notebook render pipelines from nbsphinx to myst-nb.

  • Old:

• New:

• sklearn has a download notebook feature:

[hmgomes]

that is a good way to restructure the notebook tutorials. Would it be possible to redirect the old links to the new locations of the notebooks? Just for backwards capability
Also, building the documentation would mean running the notebooks now, which makes it slightly slower to build the documentation, correct?

[tachyonicClock]

Added redirects: https://github.com/adaptive-machine-learning/CapyMOA/pull/420/changes#diff-85933aa74a2d66c3e4dcdf7a9ad8397f5a7971080d34ef1108296a7c6b69e7e3R169.
The only large build time is during release where it matters less. The pull request time is actually less because now the notebook documentation tests and the main repository tests run in parallel.