Read the Docs building from master and not latest stable

[lwcolton]

Falcon Read The Docs default version builds from the master branch of the repo. This means that the defaults docs on RTD and the latest version of falcon available from pypi do no match. My suggestion is to create a "release" branch that is kept at the same commit as the latest release, and use this for our default RTD build branch.

[ueg1990]

How would one do that? I can take a look

[lwcolton]

A normal collaborator won't be able too, it will have to be Kurt or someone else with access to RTD.

[kgriffs]

Hmm, something funny is going on. When I browse to https://falcon.readthedocs.org I am redirected to stable (https://falcon.readthedocs.org/en/stable/). At first glance it looks like the correct docs for 0.3, which is the latest tagged version in GH. If I then go to latest (https://falcon.readthedocs.org/en/latest/), I see what looks like the docs from master.

Sounds like you are seeing something different? Or am I missing some subtle difference in the docs?

[kgriffs]

P.S. Right now there are two people with access to RTD (in case I get hit by a bus, heh). I'd love to expand the group of core maintainers/reviewers if others would like to take a more active role.

[kgriffs]

This looks OK since the 1.0.0 release. Please reopen if you are seeing something different. Thanks!