NixOS / nixops

NixOps is a tool for deploying to NixOS machines in a network or cloud.
https://nixos.org/nixops
GNU Lesser General Public License v3.0
1.87k stars 364 forks source link

ReadTheDocs: fixup and get a successful render #1337

Closed grahamc closed 4 years ago

grahamc commented 4 years ago

ReadTheDocs uses a very old (1.x) Sphinx, but we're using a 3.x. In order to update it, we have to create a requirements.txt and point RTD to it with a file in the root of the project. A bit ugly, but at least we can do it! (Though it'd be cool if they supported pyproject / poetry.)

To keep the requirements.txt consistent, CI now verifies that it matches the poetry.lock (and also that poetry.lock is up to date with pyproject.toml.)

grahamc commented 4 years ago

I created my own project on RTD to test this, here it is rendered: https://nixops-testing.readthedocs.io/en/fixup-rtd/