MIME-Version: 1.0
In-Reply-To: <201206051142.34071.andres@2ndquadrant.com>
References: 
 <CABRT9RCFpt35TdrrN0jsY3YfqMiiJOTTWYWpSQKYaEdcQZKugw@mail.gmail.com>
	<CABRT9RBbNU17um=DW3VRLE0DW0ahanAo07bNLXsF73F+rhZgQA@mail.gmail.com>
	<CABUevExJFVOk4Xz4DVVKHvRAHuw7-23Uog0zsSKhagMbgXcJUA@mail.gmail.com>
	<201206051142.34071.andres@2ndquadrant.com>
Date: Tue, 5 Jun 2012 12:02:27 +0200
Message-ID: 
 <CABUevEwBZQyZLq8rG6g9zub3C12CNT7M0SW_SS3kppthd5btXQ@mail.gmail.com>
Subject: Re: [PATCH] Cross-version navigation in documentation
From: Magnus Hagander <magnus@hagander.net>
To: Andres Freund <andres@2ndquadrant.com>
Cc: Marti Raudsepp <marti@juffo.org>, pgsql-www <pgsql-www@postgresql.org>,
	Stefan Kaltenbrunner <stefan@kaltenbrunner.cc>
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

On Tue, Jun 5, 2012 at 11:42 AM, Andres Freund <andres@2ndquadrant.com> wro=
te:
> 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. Mart=
i
>> >> 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 quer=
y
>> into: versions =3D
>> DocPage.objects.filter(file=3Dfullname).extra(where=3D['version IN (SELE=
CT
>> 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 do=
n't
> especially care.

Well, I'm happy to include those *IF* we add some sort of indication
that they aren't supported. Hmm. maybe just "this page in other
version" and "this page in unsupported versions".

I'll do some experimenting :)

--=20
=A0Magnus Hagander
=A0Me: http://www.hagander.net/
=A0Work: http://www.redpill-linpro.com/