Excerpts from Nick Coghlan's message of 2013-02-26 19:32:55 +1000:
In relation to this - perhaps we should build the develop branch with
Sphinx in warning mode?
We could, although we then run the risk of doc errors not being noticed
until we go to do the release. At least now we are forced to fix them up
during development. I'm not sure which is more annoying.
I also want to add a version number to the Sphinx titles. And I was
thinking it might be worthwhile adjusting the templates somehow, to add
a little note at the top of every page in docs-develop/ explaining that
it refers to an unreleased version of Beaker and is not final, etc.
Dan Callaghan <dcallagh(a)redhat.com>
Software Engineer, Infrastructure Engineering and Development
Red Hat, Inc.