This could use a release note.

This could use a release note.

@charris, I addressed this in 484fe56. Please let me know if a "Highlight" note would be okay or if I should switch this to new_feature.

I forgot to skip Azure Pipelines and Cirrus in my previous commit – please don't mind the force-push, my apologies

I notice that for some reason the CircleCI build isn't able to load the examples, most likely because the files in source/contents/ weren't copied or that jupyterlite-pyodide-kernel was missing. I shall investigate.

Edit: I think I figured it out – CircleCI is storing the notebooks in a different path, but GitHub Pages does not do so.

Please use my GitHub Pages site to test things out: https://agriyakhetarpal.github.io/numpy/reference/maskedarray.generic.html, I have another branch at agriyakhetarpal#2 and I shall keep both of them in sync based on further commits that I push here.

I also don't see the try examples button locally - should I do anything differently other than spin docs?

@melissawm, I'm not sure – I think you'll need to refresh your conda/mamba environment, to load the new dependencies or install requirements/doc_requirements.txt, perhaps? I am able to see the buttons locally.

Nevermind - I do see it now!

d818f8c disables source maps for JupyterLite, based on scikit-learn/scikit-learn#26246. This brings the size of the JupyterLite build in the doc/build/lite/ folder from 63.3 MiB (out of the total docs size of 180.7 MiB) to 22.4 MiB (with a total docs size of 140.2 MiB), which is a 22.4% reduction in build size. While doing this has the disadvantage of making debugging slightly harder for end users, it is favourable for the aspect of saving space, especially for GitHub Pages and https://github.com/numpy/doc. I've employed the same configuration for sympy/sympy#27419 as well.

Hi @rgommers, we published https://github.com/jupyterlite/jupyterlite-sphinx/releases/tag/v0.18.0 some moments ago (thanks @steppi!), and I've updated the versions of jupyterlite-sphinx and jupyterlite-pyodide-kernel in 0713994 and 369e27d – we are good to proceed now, thanks!

Commit e7972a5 bumps to https://github.com/jupyterlite/pyodide-kernel/releases/tag/v0.5.1 that was released today, which brings the recent https://github.com/pyodide/pyodide/releases/tag/0.27.1.

(Apologies for the force push!)

Hi @melissawm, thanks for the review! I don't think I can reproduce it with CircleCI. Could you please retry with incognito mode, or with a different internet connection or mobile data if you can? This is what I get:

For reference, I tried this link: https://output.circle-artifacts.com/output/job/4b11fff4-e43b-4010-af4e-de2e84deed66/artifacts/0/doc/build/html/lite/notebooks/index.html?path=88efbc39_8e7b_4e21_86c0_519bb66f4f6a.ipynb

Based on your screenshot, I guess you're using Firefox. I tried with it as well, both with incognito mode and without, and the JupyterLite UI loads perfectly.

although the jupyterlite blocks don't work locally

They should work locally as well. Could you please share any errors or output that you might be seeing?

I think they had a partial outage eariler today so that may have been just bad luck. I'll wait for the check to finish here and test again.

@agriyakhetarpal could you update us on the next steps here? I think it includes upgrading to NumPy 2.2 in Pyodide and enabling use of nightlies, and probably also enabling functionality on the User Guide? Anything else?

Thanks, @rgommers! The following steps here are indeed those, and also, we need to add some docs to resolve gh-27310, similar to @melissawm's SciPy PR (scipy/scipy#22385, which I'll be reviewing and we can adopt similar messaging for NumPy when done).

• Upgrading to NumPy 2.2 in Pyodide was last blocked due to BUG: SciPy linalg.logm function signature mismatch with NumPy >=2.1.0rc1 due to hidden visibility for API tables #27865, but I can revisit it.
• I had a branch for starting similar work for the User Guide, but it's outdated now due to our relatively more recent changes in our approach(es). I can get started on converting the pages to MyST, though I would propose that we wait for Super compact error for docs tracebacks ipython/ipython#14591 before we merge it.
  • It probably makes sense for me to port one or two pages in a PR before getting to the rest of them all – I'd like to start with the "NumPy quickstart" page before proceeding to "NumPy: the absolute basics for beginners", as the latter is much longer.

Thanks Agriya. Docs would be a nice next step here indeed, leveraging the work Melissa did for SciPy (the setups and considerations are almost identical). It'd also be fine with me to have a shorter explanation and link to the SciPy docs on the topic for more details.

Upgrading to NumPy 2.2 in Pyodide was last blocked due to [...]

This would be good to prioritize. It seems like there was a way forward (or two possibly) there, by reverting making symbols private for example.

Re User Guide: agreed with waiting for better tracebacks and doing 1-2 pages first.

@agriyakhetarpal try_examples.json is giving a parsing error when I try updating circleci to Python 3.13. It looks like perfectly good json, so I wonder where the problem is. Maybe the environment? Any ideas?