Notebook documentation

[ebezzi]

Adds notebook based documentation. Uses a Sphinx extension named nbsphinx that can convert ipynb notebooks into rst files at build time.

Note that the notebooks are symlinked, so any change to a notebook will also be reflected in the docs automatically. This has the advantage of not having to modify extra files, but the drawback is that the examples cannot be manually edited. If this isn't desirable, we can use pandoc to convert the notebooks to static rst files and just include them as part of the documentation sources.

[codecov]

Codecov Report

Merging #218 (fa17ed5) into main (32ea406) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main     #218   +/-   ##
=======================================
  Coverage   81.87%   81.87%           
=======================================
  Files          28       28           
  Lines        1572     1572           
=======================================
  Hits         1287     1287           
  Misses        285      285           

Flag	Coverage Δ
unittests	81.87% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more