The readable version of the docs is hosted at mesa.readthedocs.org.
This folder contains the docs that build the docs for the core mesa code on readthdocs.
Updating docs can be confusing. Here are the basic setups.
- Create branch (either via branching or fork of repo) -- try to use a descriptive name.
git checkout -b doc-updates
- Update the docs. Save.
- Build the docs, from the inside of the docs folder.
- Requires sphinx:
pip install sphinx
- Requires nbsphinx:
pip install nbsphinx
(this will render the images from jupyter in the docs) make html
- Requires sphinx:
- Commit the changes. If there are new files, you will have to explicit add them.
git commit -am "Updating docs."
- Push the branch
git push origin doc-updates
- From here you will want to submit a pull request to main.
From this point, you will need to find someone that has access to readthedocs. Currently, that is @jackiekazil, @rht, and @tpike3.
- Accept the pull request into main.
- Log into readthedocs and launch a new build -- builds take about 10 minutes or so.
- Build html from docs:
make html
- Autogenerate / update sphninx from docstrings (replace your name as the author:
sphinx-apidoc -A "Jackie Kazil" -F -o docs mesa/