MyST-NB parses jupyter notebooks and markdown in Sphinx, thereby replacing nbsphinx (for .ipynb files) and recommonmark (for .md files). The powerful MyST (Markedly Structured Text) parser also allows much of the documentation to be written in Markdown instead of reStructuredText, which can make it easier for new folks wanting to make contributions to the documentation.

Use MyST markdown parser instead of reStructuredText parser.

Gets rid of autosummary toctree warnings, see https://stackoverflow.com/questions/12206334/sphinx-autosummary-toctree-contains-reference-to-nonexisting-document-warnings/43237890#43237890. Also need to add sphinx autosummary extension I think.

API docs didn't have proper links because *.ipynb files were generated instead of *.rst files, some buggy hardcoding apparently. Workaround is to put the ".rst" line first in Sphinx's conf.py. Also removed a numpydoc config, and ensure API docs are generated to doc/source/_icepyx (which is gitignored).

…tion

Put the rendered ICESat-2_DAAC_DataAccess_Example jupyter notebook in the User Guide! No need to visit GitHub to see the jupyter notebook anymore!

See https://myst-parser.readthedocs.io/en/v0.13.6/using/syntax-optional.html#linkify. Converts https URLs into clickable links, e.g. those at the end of the Code of Conduct page.

See https://myst-parser.readthedocs.io/en/v0.13.6/using/howto.html#automatically-create-targets-for-section-headers. Fixes WARNING: duplicate label xxx, other instance in yyy (mostly in the changelog page).

This reverts commit 2072419.

Prevents `WARNING: Non-consecutive header level increase; 0 to 2 [myst.header]` when building docs.

Fixes `WARNING: duplicate label getting_started/example_notebooks/working_with_icesat-2_data_variables:example 1: choose variables, other instance in ...`

Increase visibility of the jupyter notebook examples on the readthedocs page.

This reverts commit fd237e7.

This reverts commit a161b42.

This reverts commit db480e7.