Proposed role: debops.rtfd

[ypid]

As it seems to me that we now hit the build time limit on readthedocs.org I would suggest we write a role to self host our own read-the-docs service. Anyone wants to do it? This is kind of urgent.

Ref: https://read-the-docs.readthedocs.io/en/latest/install.html Obsoletes proposal: debops.sphinx Related to: https://github.com/debops/docs/issues/147

[drybjed]

Sounds like the role could be based on the debops.netbox role which deploys Python application using virtualenv.

[ypid]

I have just been playing with GitLab and this could also be solved with using GitLab CI. The docs get build currently during CI anyway (Travis CI). Using GitLab artifacts and GitLab Pages, it is pretty easy to set it up so that in the test stage the docs get build and only if that succeeds, the docs get deployed. I actually quite like this approach. Also because then the docs are only build once. No redundant builds and we already have the roles for GitLab :)

Example: https://gitlab.com/ypid/hc (Check the coverage report)