Documentation repository for spatial
Restructured text is annoying (particularly for tables), so we use a preprocessor to make site maintenance easier.
The preprocessor reads from docs/site and generates to docs/source
(Naming of source is due to the default commands for running sphinx-build on readthedocs)
docs/site - files for site
docs/source - preprocessed files (cleared before every build)
docs/build - built html files
src/... - preprocessor
- Make edits to
docs/siteONLY - not todocs/source - Run
makelocally - Verify changes in docs/build/index.html using local web browser
- Commit all changes to
docs/siteanddocs/source