MIME-Version: 1.0
In-Reply-To: <201205281344.51634.andres@2ndquadrant.com>
References: 
 <CABRT9RCFpt35TdrrN0jsY3YfqMiiJOTTWYWpSQKYaEdcQZKugw@mail.gmail.com>
	<CABUevEyuu2kJhqjv9kSovuwg99sKf5zYKASXf=3d8ffKnQZ4aA@mail.gmail.com>
	<201205281344.51634.andres@2ndquadrant.com>
From: Marti Raudsepp <marti@juffo.org>
Date: Wed, 30 May 2012 12:58:26 +0300
Message-ID: 
 <CABRT9RBbNU17um=DW3VRLE0DW0ahanAo07bNLXsF73F+rhZgQA@mail.gmail.com>
Subject: Re: [PATCH] Cross-version navigation in documentation
To: Magnus Hagander <magnus@hagander.net>
Cc: Andres Freund <andres@2ndquadrant.com>,
	pgsql-www <pgsql-www@postgresql.org>,
	Stefan Kaltenbrunner <stefan@kaltenbrunner.cc>
Content-Type: text/plain; charset=UTF-8

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.

In theory we could mine git history to extract page
renames/merges/splits, but it sounds like a lot of effort for little
gain.

On Sun, May 27, 2012 at 9:40 PM, Magnus Hagander <magnus@hagander.net> wrote:
> On Sunday, May 27, 2012, Marti Raudsepp wrote:
>> PS: Python projects have a nearly universal style of using 4-space
>> indents (PEP-0008).

> I don't really see the point. If your editor can't be consistent about
> tabs/spaces, you probably have a bigger problem

Well I need to reconfigure my editor to edit these files.

>> 0001-Allow-documentation-loading-without-tidy-Tidylib-for.patch
> More to the point though - if we want a feature like that, it should be
> controlled by a parameter that turns it off, not by automatically doing it.

Ok, agreed.

Regards,
Marti