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 reason).

https://github.com/Pylons/pyramid/blob/master/docs/conf.py#L161

It would probably be good to have an outdated=True flag set on old branches
that would then point you back to /latest or something.

The URL format is /<major>.<minor>-branch, with 1.4 as /latest the latest
stable, and /master as master (in development).


On Fri, Feb 8, 2013 at 11:09 AM, Jonathan Vanasco <jonat...@findmeon.com>wrote:

> 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 that i wanted to try and patch the templates
> to add some SEO tricks and also an alert box that appears on specific
> version branches, and lets people know that the docs are ( or may be )
> out of date -- and pointing to the latest release.
>
> i've referenced out-of-date docs a few times from search engines
> myself, and i've seen many others with the same issues.  would love to
> stop it.
>
> --
> You received this message because you are subscribed to the Google Groups
> "pylons-devel" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to pylons-devel+unsubscr...@googlegroups.com.
> To post to this group, send email to pylons-devel@googlegroups.com.
> Visit this group at http://groups.google.com/group/pylons-devel?hl=en.
> For more options, visit https://groups.google.com/groups/opt_out.
>
>
>

-- 
You received this message because you are subscribed to the Google Groups 
"pylons-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to pylons-devel+unsubscr...@googlegroups.com.
To post to this group, send email to pylons-devel@googlegroups.com.
Visit this group at http://groups.google.com/group/pylons-devel?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to