better describe how to build the environment

[12rambau]

I'm a regular python developer so I know how to build an environment using pip based on the requirement.txt file, the setup.py in or out of a venv. I can more or less do the same using conda and a environment.yml. I never directly deal with either the .bz2 or the .whl of the tools I'm using. I think this describe more or less the classic python lib developer and thus the classic Sphinx user.

Would it be possible to improve the documentation to better understand how I can add matplotlib to the jupyterlite env ?

• What is a federated_extention ? at the moment google result is pointing to a jupyterlite issue which gives no better understanding (https://www.google.com/search?client=safari&rls=en&q=numpy+federated+extension&ie=UTF-8&oe=UTF-8)
• Why do I need both the conda and the wheel ?
• How can I know which platform to use ?
• Do the version of the .whl and .bz2 need to match ?
• why do you skip sys_prefix in the exemple ?

[martinRenou]

Would it be possible to improve the documentation to better understand how I can add matplotlib to the jupyterlite env ?

Definitely we should 👍🏽

What is a federated_extention ? at the moment google result is pointing to a jupyterlite issue which gives no better understanding (https://www.google.com/search?client=safari&rls=en&q=numpy+federated+extension&ie=UTF-8&oe=UTF-8)

A federated extension is an extension for the JupyterLab front-end. In the simple case of Matplotlib, you should not need to know what this is.

In the case of bqplot here, bqplot has both a Python package and a front-end extension based on d3js that is a federated extension.

why do you skip sys_prefix in the exemple ?

This config entry could probably be removed to simplify the config.

---

I think we should have two sections in the docs:

• One using JupyterLite's pyolite kernel approach of giving wheels in the config
• One using jupyterlite-xeus-python (which is easier to setup IMHO) https://xeus-python-kernel.readthedocs.io/en/latest/configuration.html.