This could use a release note.

This could use a release note.

@charris, I addressed this in484fe56. Please let me know if a "Highlight" note would be okay or if I should switch this tonew_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 becausethe files insource/contents/ weren't copied or thatjupyterlite-pyodide-kernel was missing. I shall investigate.

Edit: I think I figured it out – CircleCI is storing the notebooks ina 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 atagriyakhetarpal#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 yourconda/mamba environment, to load the new dependencies or installrequirements/doc_requirements.txt, perhaps? I am able to see the buttons locally.

Nevermind - I do see it now!

d818f8c disablessource maps for JupyterLite, based onscikit-learn/scikit-learn#26246. This brings the size of the JupyterLite build in thedoc/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 debuggingslightly harder for end users, it is favourable for the aspect of saving space, especially for GitHub Pages andhttps://github.com/numpy/doc. I've employed the same configuration forsympy/sympy#27419 as well.

Hi@rgommers, we publishedhttps://github.com/jupyterlite/jupyterlite-sphinx/releases/tag/v0.18.0 some moments ago (thanks@steppi!), and I've updated the versions ofjupyterlite-sphinx andjupyterlite-pyodide-kernel in0713994 and369e27d – we are good to proceed now, thanks!

Commite7972a5 bumps tohttps://github.com/jupyterlite/pyodide-kernel/releases/tag/v0.5.1 that was released today, which brings the recenthttps://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 resolvegh-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 toBUG: SciPylinalg.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 forSuper 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.

@agriyakhetarpaltry_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?