Improve documentation on Jupyter and JupyterLab

[astrojuanlu]

🐞 Problem

JupyterLab is a new environment, and some extra steps are needed to get things working: in particular, the user needs NodeJS and two extensions, @jupyter-widgets/jupyterlab-manager and @jupyterlab/plotly-extension for 3D.

Also, it's not clear in which versions of IPython/Jupyter is %matplotlib inline needed, and that deserves some documentation as well.

🎯 Goal

Make it easier for newcomers to have a poliastro environment up and running.

📋 Steps to solve the problem

• Comment below about what you've started working on.
• Add, commit, push your changes
• Submit a pull request and add this in comments - Addresses #<put issue number here>
• Ask for a review in comments section of pull request
• Celebrate your contribution to this project 🎉

[shreyasbapat]

Where exactly do you plan to put this? Like under what section?

[astrojuanlu]

What about "Getting started"?

[astrojuanlu]

By the way: next version of nbconvert will finally have support for ipywidgets >= 7, which means: dynamic widgets in static HTML!

jupyter/nbconvert#636 (comment)

So, after it's released, we can start testing using widgets more.

On the other hand, there's an ongoing discussion on whether Jupyter should save the widget status by default or not:

jupyter-widgets/ipywidgets#1632 (comment)

Which, IMHO, is the final tweak that's needed for them to be as usable as the old HTML static output (see also python-visualization/folium#874 (comment))

[astrojuanlu]

nbconvert 5.4 is around the corner:

jupyter/nbconvert#869

[shreyasbapat]

https://github.com/plotly/plotly.py/blob/master/README.md#jupyterlab-support-python-35
This should also go somewhere!

[astrojuanlu]

Isn't it already there?

https://docs.poliastro.space/en/stable/getting_started.html#using-poliastro-on-jupyterlab

[astrojuanlu]

I mean... You added those! #459

[shreyasbapat]

Not all of them :/
One that's not added: (Most Crucial)

FigureWidget support

jupyter labextension install [email protected]

[shreyasbapat]

Moreover, there is nothing like plotly extension mentioned over there :/

[astrojuanlu]

Oh, you're right! Perhaps the extension is outdated? In any case, reopening. All yours :)

[shreyasbapat]

On it!

[astrojuanlu]

Thanks @shreyasbapat! Re-closing :)