Our use of `fs` means we have a runtime dependency on setuptools. The
newest version is not compatible with the current version of `fs` so
we've added a constraint. But the docs build didn't previously install
our specified version of setuptools. This is to fix that.
Now that there is only one sphinx project, the RTD config can be more
specific and stop relying on the old style config which is about to be
deprecated.
This repo currently builds multiple RTD projects out of it and the yaml
config doesn't really have a way to specify which project it's for so we
keep this minimal.
The hope is that any settings it doesn't find here it will pick up from
the advanced project settings in RTD.
We need to explicitly set the python version because RTD seems to be
defaulting to Python 3.7 otherwise and that's not compatible with some
of the requirements in our docs.txt file which no longer support
python<3.8
We need to explicitly list any extra requirements files we want to
install and that can't be set per project but luckily all the doc
projects share the same requirements file.