We use Read the Docs in our development workflow, which has been great so far.
However, we can transition to a combo of our existing GitHub Actions and inclusion of GitHub Pages. This will reduce the complexity a bit, and make the build workflow more transparent.
Benefits:
- allow us to locally verify that the PDF and HTML output will work (no magic)
- one service dependency less
- further actions to get transfer of static files to final destination to work needs this anyway
Clean up after transition:
- remember to retire Read the Docs site orderly, e.g. "We've moved to ..." page for 3 months
- decommission RtD completely
We use Read the Docs in our development workflow, which has been great so far.
However, we can transition to a combo of our existing GitHub Actions and inclusion of GitHub Pages. This will reduce the complexity a bit, and make the build workflow more transparent.
Benefits:
Clean up after transition: