Case Study: Numpy Tutorials and Developer Conference in Copenhagen 2025

[choldgraf]

What happened

• The scientific python tutorials now use Jupyter Book 2: https://numpy.org/numpy-tutorials/
• This came out of the recent scientific python developer conference in Copenhagen: https://scientific-python.org/summits/developer/2025-nov/

What's exciting or useful about it

• NumPy has been contributing to the JB2 stack to bring it up to functionality needed by numpy
• We're excited to see JB2 being used in a major OSS scientific python tool!

Where can I learn more?

• PR that implemented this: ENH: switch to the mystmd enginery for rendering numpy/numpy-tutorials#274

[choldgraf]

from @bsipocz

The SP summit was useful 1) we could share out experiences around testing and deploying tutorials and learnt from what the sklearn team is doing. and 2) for swapping out the numpy tutorials from the sphinx based system it was useful to be in one space and having a time limit to make the changes -- it was just the right sized project.
Challenges -- good question, some minor challenges were to what order to swap the CI (I wouldn't really mention it); and the challenges could be the things we already went through e.g. that we want to switch (many others don't want to move on from sphinx)

[bsipocz]

cc @rossbar - you have better words than for this

[bsipocz]

@choldgraf - "The scientific python tutorials now use Jupyter Book 2" it's not SP tutorials but numpy ones :)