[pytest-dev] pytest docs on readthedocs?

[Bruno Oliveira]

Hi everyone,

Currently one of the steps involved in the release process is manually
generating the documentation and uploading to pytest.org (using rsync).

I was wondering if we should move pytest docs over to readthedocs.org? It
automatically builds and hosts the documentation based on tags or branches,
so it would simplify the release build process a bit, plus it automatically
hosts multiple versions of the documentation (would be nice to see how the
docs for 2.9 in the features branch look like, for instance).

Readthedocs even supports using canonical urls[1] so users would still
access the documentation through pytest.org.

Also, pytest.readthedocs.org already exists and hosts documentation for the
2.7.0 release. Ronny cleverly noticed that that release probably was the
last release before moving to GitHub, otherwise it would be still serving
up-to-date documentation as the project on readthedocs is still configured
to clone the bitbucket repository.

Holger, you are the owner[2] of pytest.readthedocs.org, do you remember if
there was a reason to not fully move documentation hosting over there?

What others think of this idea?

[1] https://docs.readthedocs.org/en/latest/canonical.html
[2] https://readthedocs.org/projects/pytest/

Cheers,
Bruno.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/pytest-dev/attachments/20160122/3deec73a/attachment.html>