improve example notebooks in docs

[JessicaS11]

Per the discussion in #196, now that the example notebooks are rendered on the docs page, we wanted them to be in their own section and the section headings needed to be made consistent. This PR largely addresses #257 and adds #264.

[github-actions]

👈 Launch a binder notebook on this branch for commit dcae8fe

I will automatically update this comment whenever this PR is modified

👈 Launch a binder notebook on this branch for commit 447d243

👈 Launch a binder notebook on this branch for commit e12eb73

👈 Launch a binder notebook on this branch for commit c884967

👈 Launch a binder notebook on this branch for commit ab16f5c

👈 Launch a binder notebook on this branch for commit 3e5c2e5

👈 Launch a binder notebook on this branch for commit 68d7036

👈 Launch a binder notebook on this branch for commit ad24045

👈 Launch a binder notebook on this branch for commit 3e7e120

👈 Launch a binder notebook on this branch for commit 97c19c3

👈 Launch a binder notebook on this branch for commit 593f409

👈 Launch a binder notebook on this branch for commit d42dc08

👈 Launch a binder notebook on this branch for commit f3b1025

👈 Launch a binder notebook on this branch for commit e061fca

👈 Launch a binder notebook on this branch for commit 968935d

👈 Launch a binder notebook on this branch for commit aef9860

👈 Launch a binder notebook on this branch for commit 260cdae

👈 Launch a binder notebook on this branch for commit 990c3ba

👈 Launch a binder notebook on this branch for commit a648259

[weiji14]

Great work @JessicaS11, this looks really neat! Makes it really easy for the user to walk through icepyx's functionality 😁

In terms of suggestions, I'm wondering if there's a way to get an automatic download link to the Jupyter notebook? I found executablebooks/MyST-NB#124 but wasn't sure how to activate it, maybe some configuration/plugin in Sphinx or MyST that can do the trick?

[JessicaS11]

In terms of suggestions, I'm wondering if there's a way to get an automatic download link to the Jupyter notebook? I found executablebooks/MyST-NB#124 but wasn't sure how to activate it, maybe some configuration/plugin in Sphinx or MyST that can do the trick?

That's a great idea! I'll look into it more.

[JessicaS11]

It turns out the directive is available in the jupyter-sphinx extension, but the docs are outdated enough that they have the wrong roles listed. I found an example using it (see the footnote), and have since figured out that it does need the .ipynb extension. Filed an issue here.

[weiji14]

It turns out the directive is available in the jupyter-sphinx extension, but the docs are outdated enough that they have the wrong roles listed. I found an example using it (see the footnote), and have since figured out that it does need the .ipynb extension. Filed an issue here.

Good work tracking this down! I always find Sphinx plugins/configs hard to track down, they seem all over the place 😆

[JessicaS11]

Good work tracking this down! I always find Sphinx plugins/configs hard to track down, they seem all over the place 😆

Thanks - and I agree! Though it turns out what I'd actually done was stumble upon the undocumented MyST-NB role (and for some reason Sphinx couldn't find the jupyter-sphinx ones - which are documented and current - even when I'd installed the extension).