Re: [PATCH] Cross-version navigation in documentation - Mailing list pgsql-www

From Marti Raudsepp
Subject Re: [PATCH] Cross-version navigation in documentation
Date
Msg-id CABRT9RBbNU17um=DW3VRLE0DW0ahanAo07bNLXsF73F+rhZgQA@mail.gmail.com
Whole thread Raw
In response to Re: [PATCH] Cross-version navigation in documentation  (Andres Freund <andres@2ndquadrant.com>)
Responses Re: [PATCH] Cross-version navigation in documentation
List pgsql-www
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


pgsql-www by date:

Previous
From: Marti Raudsepp
Date:
Subject: Re: searching for git commit hash
Next
From: Greg Stark
Date:
Subject: Re: searching for git commit hash