DHI
Notebook examples in documentation
Users shouldn't have to visit the Github repo to read notebooks.
Including them in the docs makes it possible to navigate to a specific section of a notebook, e.g. http://domain.com/examples/Hydrology_Vistula_Catchment/#statistics-aggregated-by-month
TODO:
- [ ] Include relevant notebooks
- [ ] Rendering of xarray repr_html not ideal
- [ ] Consider to execute notebooks as part of the docs rendering
P.S. I didn't manage to reference the notebooks in the /notebooks folder, thus I added them as symbolic links to /docs/examples
It's nice except those symbolic links are not working on windows which means that the documentation can no longer be build on windows🤔
Too bad, so how about copying the most relevant examples to the docs and keeping the notebooks folder as a repository of less polished examples?
Yeah, or do some manual work (copy notebooks manually) when I once a while build the documentation locally? Let's decide next year 🎇