Re: Links for upgraders - Mailing list pgsql-docs

From Tom Lane
Subject Re: Links for upgraders
Date
Msg-id 2469.1392248425@sss.pgh.pa.us
Whole thread Raw
In response to Re: Links for upgraders  (Peter Eisentraut <peter_e@gmx.net>)
Responses Re: Links for upgraders
List pgsql-docs
Peter Eisentraut <peter_e@gmx.net> writes:
> I think it would be even better to link directly to the migration notes,
> not to the top-level section of the release notes.  I suggest to add a
> link target like

>   <sect2 id="release-9-2-4-migration">
>    <title>Migration to Version 9.2.4</title>

> and then link to that.

I experimented with this and didn't really find that it improved the
browsing experience any compared to what Vik did.  It might be noticeably
better if we had any significant amount of text above the "migration"
section, but we never do.

I'd prefer *not* to add yet another place where the version number
has to be manually adjusted each time one makes a new release-notes
section.  (This is a task we've failed at a few times in the past ;-),
so I'm not just hypothecating.)  So I'm -1 for this unless there's
really, really strong contrary opinion.

            regards, tom lane


pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: [HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)
Next
From: "Joshua D. Drake"
Date:
Subject: Re: Links for upgraders