From: Andres Freund <andres@2ndquadrant.com>
Organization: 2ndquadrant.com
To: Magnus Hagander <magnus@hagander.net>
Subject: Re: [PATCH] Cross-version navigation in documentation
Date: Tue, 5 Jun 2012 11:42:33 +0200
User-Agent: KMail/1.13.7 (Linux/3.4.0-andres; KDE/4.7.4; x86_64; ; )
Cc: Marti Raudsepp <marti@juffo.org>, "pgsql-www" <pgsql-www@postgresql.org>,
	Stefan Kaltenbrunner <stefan@kaltenbrunner.cc>
References: 
 <CABRT9RCFpt35TdrrN0jsY3YfqMiiJOTTWYWpSQKYaEdcQZKugw@mail.gmail.com>
	<CABRT9RBbNU17um=DW3VRLE0DW0ahanAo07bNLXsF73F+rhZgQA@mail.gmail.com>
	<CABUevExJFVOk4Xz4DVVKHvRAHuw7-23Uog0zsSKhagMbgXcJUA@mail.gmail.com>
In-Reply-To: 
 <CABUevExJFVOk4Xz4DVVKHvRAHuw7-23Uog0zsSKhagMbgXcJUA@mail.gmail.com>
MIME-Version: 1.0
Content-Type: Text/Plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
Message-Id: <201206051142.34071.andres@2ndquadrant.com>

On Tuesday, June 05, 2012 10:59:54 AM Magnus Hagander wrote:
> On Wed, May 30, 2012 at 11:58 AM, Marti Raudsepp <marti@juffo.org> wrote:
> > On Mon, May 28, 2012 at 2:44 PM, Andres Freund <andres@2ndquadrant.com> 
wrote:
> >> The amount of pages actually having been renamed isn't that big. Marti
> >> opened up his version of the docs to me and I browsed along and even
> >> between 7.4 and 9.1 I had a hard time finding pages where you would
> >> expect a link from 7.4 forwards.
> > 
> > Exactly. And people rely on page names right now anyway -- they find
> > the page on Google and then just change the version number in the URL
> > and see if it works. Either that, or they will read the wrong version.
> > What I'm proposing solves >95% of the cases and I think that is good
> > enough.
> 
> Given that nobody has objecte,d I'm going to go ahead and do this.
Great!

> However - should we perhaps just list supported versions? Turns the query
> into: versions =
> DocPage.objects.filter(file=fullname).extra(where=['version IN (SELECT
> tree FROM core_version WHERE
> supported)']).order_by('-version').only('version', 'file')
> 
> or if we do want to list all versions, we should somehow indicate
> which versions are supported and not on this list as well, I think.
> But I'm happy to just listed supported versions for now.
I personally would like to see older versions there because every now and then 
I need to look something up for them, but its infrequent enough that I don't 
especially care.

Thanks!

Andres


PS: Sorry Magnus, youve got the email twice. I recently reconfigured my mail 
client to disassociate reply-all from its previous key combination and I 
havent fully retrained myself.

-- 
 Andres Freund	                   http://www.2ndQuadrant.com/
 PostgreSQL Development, 24x7 Support, Training & Services