DOC: interactive docs with marimo

[lucascolley]

Draft for now, TODO:

• integrate with the full docs (there are a few ways we could do this - have a small sphinx theme page for the home page? Try to make the entire docs just one notebook? Keep using jupyterbook even if it doesn't handle the tutorial any more?)
• update the CI workflow etc.

You should be able to try this out by checking out this branch and running pixi run tutorial!

[lucascolley]

do let me know what you think about this approach from a high level @mdhaber !

[lucascolley]

It sounds like it should be simple enough to just include this in the existing JupyterBook project as an html page.

We could always switch over to a static marimo notebook for now and explore making it interactive in a follow-up. I think we may have to wait for Pyodide to get the latest versions of packages for everything to work as it does locally.

[lucascolley]

I'm not sure why marimo doesn't use the repr by default like Jupyter, but that seems deliberate based on the docs at https://docs.marimo.io/guides/integrating_with_marimo/displaying_objects/. Seems fine to just implement _display_ as they suggest?

[lucascolley]

marimo-team/marimo#3644

[mdhaber]

It sounds like I would need to use Marimo to edit the notebook, not Jupyter Lab?

I was hoping to just use whatever system SciPy does to make the notebook interactive. Was that not possible, or did you want to change everything to marimo?

[lucascolley]

I was hoping to just use whatever system SciPy does to make the notebook interactive. Was that not possible, or did you want to change everything to marimo?

I think that's an alternative option, yes. I was using this as an opportunity to explore marimo a bit.

I don't think either way will work at the minute as it seems like we need a more recent version of NumPy than what is on Pyodide.