Documentation as notebooks and vice versa

[soxofaan]

Interesting observation from Google Earth Engine community docs: e.g. https://developers.google.com/earth-engine/tutorials/community/intro-to-python-api-guiattard is written as a notebook (https://github.com/google/earthengine-community/blob/master/tutorials/intro-to-python-api-guiattard/index.ipynb), but seamlessly integrated in their documentation tree

It could be useful to adapt that approach as well for a part of the openEO python lib documentation (e.g. quick start or tutorials):

• makes it easy to check that snippets are valid (could be even part of integration test suite)
• allows user to start experimenting directly from docs downloaded as notebook

[soxofaan]

This seems to be a sphinx plugin that supports this: https://nbsphinx.readthedocs.io/