Add notebook examples to documentation

notebooks can be rendered by sphinx:
https://sphinx-nbexamples.readthedocs.io/en/latest/

Start by reviewing the repository's documentation and any existing notebook examples, then read the linked sphinx-nbexamples documentation to understand the intended rendering setup. Done means the relevant notebook examples are included in the documentation and render successfully, but the issue does not identify which notebooks or documentation files to change.

Written by the indexing model from the issue text.