The only caveat I see from this diff is that it forces people to use tox to build docs reliably.

I don't mind (I almost never use direct commands anymore) but some people might?

(also, looking at these files, a bunch of django < 2s should go away)

In D3073#74823, @olasd wrote:

The only caveat I see from this diff is that it forces people to use tox to build docs reliably.
I don't mind (I almost never use direct commands anymore) but some people might?

As long as it is still possible to just build the doc for a specific project, I also don't mind.

+1 on @anlambert request, can we have a more abstract UI rather than "tox -e sphinx-dev" to build the doc?
Ideally, as running "make" under swh-foo/docs right now just works, maybe we can make that invoke the needed tox voodoo?

In D3073#74847, @anlambert wrote:

While individual doc build can still be launched in each subproject, I am fine with it.

As far as I know, this diff should not impact the ability to locally build the doc.

Could we manage to launch tox -r -e sphinx-dev when calling make ?

I managed to do it by adding this in swh-docs/Makefile.local

tox-doc:
	tox -r -e sphinx-dev

all: tox-doc

Calling make in swh-docs will then launch tox.

There is also a dependency in requirements.txt to update: swh.storage[schemata,listener] => swh.storage[schemata]