# Interactive docs @ Scientific Python Dev Summit 2024

## Notes

- What is the proposed infrastructure for executable examples/pages in Sphinx-generated documentation?
- What are the missing pieces to make this solution available for all interested projects?
- What are potential concerns and questions that would prevent projects from adopting this approach?

## Current status

- Text-based jupyter notebooks can be rendered into narrative html docs with sphinx + mystnb
- API documentation examples can be made interactive with Jupyterlite + jupyterlite-sphinx. This depends on pyodide, and for each project a kernel needs to be built and released with a new pyodide release.
- - **Why can't we build our own pyodide kernel?**
- https://github.com/pyodide/pyodide/pull/4719
- Agriya: I know I have to return to this. Thanks for bringing this up. 😅
- C and Fortran code make it harder
- Pure python project: https://pywavelets.readthedocs.io/en/latest/ref/wavelets.html#wavelet-families
- Correction from Agriya Khetarpal, 15/06/2024: PyWavelets is actually Cython-based and compiled
- Is it necessary to have wheels in pyodide, or could we host/build our own?
- cibuildwheel supports wasm wheels now
- Agriya: relevant PR is https://github.com/pypa/cibuildwheel/pull/1456/
- Available in v2.19.0, v2.19.1, and onwards
- https://github.com/PyWavelets/pywt/pull/744
- https://jupyterlite-sphinx.readthedocs.io/en/latest/

## References

- https://github.com/scientific-python/summit-2024/issues/19