Add documentation build script, fix build warning, and update docs on building docs#584
Conversation
Previously it was throwing a warning, which was being ignored. We should not ignore warnings :)
It also cleans up because a previous build output can cause the build to fail.
|
Looks like I broke RTD build, returning to draft |
|
Integration tests report: appsharing.space |
|
Figured it out. Can specify the Python modules as dependencies in #585 to try and make the python packages' dependencies more self-contained. |
|
Would like to hear your feedback @YaoTingYao ! I don't like that this makes our instructions a bit more complicated, but I think the best course is to accept that until we can figure out how to make our Python package builds more self-contained (#585) |
Description
Local builds were failing because of a warning thrown by autodoc because
jupytergis_labwas not installed, soGISDocumentcouldn't be found by autodoc. Editedenvironment-docs.ymlto support this.Also, the documentation documentation (:smile:) was suggesting using
make, when we don't have aMakefile. I added a script instead and updated the docs correspondingly.Checklist
Resolves #XXX.Failing lint checks can be resolved with:
pre-commit run --all-filesjlpm run lint📚 Documentation preview: https://jupytergis--584.org.readthedocs.build/en/584/
💡 JupyterLite preview: https://jupytergis--584.org.readthedocs.build/en/584/lite