Re: how are the pyramid docs managed ?

2013-02-08 Thread Domen Kožar
And tags to v1.4, yes :) On Fri, Feb 8, 2013 at 10:49 PM, Tshepang Lekhonkhobe wrote: > Would it solve the problem if the branches were simply renamed, from > e.g "1.4-branch" to "1.4"? > > On Fri, Feb 8, 2013 at 9:23 PM, Michael Merickel > wrote: > > We are limited by what readthedocs is actua

Re: how are the pyramid docs managed ?

2013-02-08 Thread Tshepang Lekhonkhobe
Would it solve the problem if the branches were simply renamed, from e.g "1.4-branch" to "1.4"? On Fri, Feb 8, 2013 at 9:23 PM, Michael Merickel wrote: > We are limited by what readthedocs is actually capable of doing. It doesn't > support branch aliases right now, so unless we make a "stable" br

Re: how are the pyramid docs managed ?

2013-02-08 Thread Blaise Laflamme
Hi jonathan, feel free to modify the sphinx theme and send a pull request. Actually older versions like 1.1, 1.2, etc, are not out-of-date but up-to-date with those versions. There are the latest and the development one that reflects the current stable and development versions of Pyramid. A men

Re: how are the pyramid docs managed ?

2013-02-08 Thread Michael Merickel
We are limited by what readthedocs is actually capable of doing. It doesn't support branch aliases right now, so unless we make a "stable" branch that we merge with "1.4-branch" every time we update, we make do with latest. Same issue with the major.minor -branch issue. If someone wants to add ali

Re: how are the pyramid docs managed ?

2013-02-08 Thread Tshepang Lekhonkhobe
On Fri, Feb 8, 2013 at 7:29 PM, Michael Merickel wrote: > The URL format is /.-branch, with 1.4 as /latest the latest > stable, and /master as master (in development). * I find this misleading. I would expect "latest" or "dev" to refer to "master", and 1.4 (latest stable release) be referred to a

Re: how are the pyramid docs managed ?

2013-02-08 Thread Michael Merickel
The docs are built automatically from specific branches in the repository by readthedocs. The sphinx template is managed by Blaise, and there is already at least the "in_progress" option to the template which will show a warning on the master docs (looks like it's not turned on right now for some

how are the pyramid docs managed ?

2013-02-08 Thread Jonathan Vanasco
what controls how the pyramid docs get built and stored onto doc.pylonsproject ? looking at the github source ( https://github.com/Pylons/pyramid/tree/master/docs ) it looks to me like only the current docs are in master, and the older ones are built off misc releases the reason why i ask, is th