We need a place to publish the RTD docs for the repo. We have three options:
github-pages - downside - the generated pages become part of the repo, and the dev needs to generate the pages from time to time. Benefit - once setup, easy to use - generate and push to github
readthedocs.org - downside - external publishing and need to have an account set up on the site and do some local set up. Benefit - once setup, easy to use and no need for pre-push generation by the dev.
self-hosted - downside - have to setup a pipeline to generate the pages and publish them. Benefit - once setup, easy to use and no need for pre-push generation by the dev. Basically - the same ongoing effort as readthedocs.org, but more effort to setup each one.
Leaning to github-pages as the dev should be reviewing the docs when making changes anyway, so updating the docs should be straight forward. The admin overhead of having a readthedocs.org account seems like a pain.
We need a place to publish the RTD docs for the repo. We have three options:
Leaning to github-pages as the dev should be reviewing the docs when making changes anyway, so updating the docs should be straight forward. The admin overhead of having a readthedocs.org account seems like a pain.
I've tried the readthedocs.org - https://von-agent.readthedocs.io/en/latest/
Now trying the github-pages approach.