Use Papyri to explore documentation

[TomNicholas]

What is your issue?

At Scipy @Carreau demo'ed a new docs engine: Papyri. (You can find the talk slides here).

In short it looks awesome, and we should use it to improve our docs!

You should watch the talk, but Papyri allows:

• bidirectional crosslinking across libraries,
• navigation,
• proper reflow of user docstrings text,
• proper reflow of inline images (when rendered to html),
• proper math rendering (both in terminal and html), and more.

There is also a jupyter-lab extension in the works.

One of the examples in the talk uses xarray docs, as papyri builds from our .rst files.

Here I have "ingested" both xarray and numpy docs, which papyri's explorer dynamically links together in both directions.

I think this is super cool, and we should think about using it. However the project is extremely early stage, and currently has many bugs, and no unified way to ship it (the example was made locally).

I encourage other xarray devs to have a look and a think about how we can use it / benefit / test it out though!