Received: from malur.postgresql.org ([217.196.149.56])
 by arkaria.postgresql.org with esmtp (Exim 4.80) (envelope-from
 <pgsql-docs-owner+M7937=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
 id 1WDjQG-0002Zl-Uq
 for pgsql-docs@arkaria.postgresql.org; Wed, 12 Feb 2014 23:40:57 +0000
Received: from localhost ([127.0.0.1] helo=postgresql.org)
 by malur.postgresql.org with smtp (Exim 4.80) (envelope-from
 <pgsql-docs-owner+M7937=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
 id 1WDjQG-0005yN-AO
 for pgsql-docs@arkaria.postgresql.org; Wed, 12 Feb 2014 23:40:56 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
 by malur.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <tgl@sss.pgh.pa.us>) id 1WDjQF-0005yH-Np
 for pgsql-docs@postgresql.org; Wed, 12 Feb 2014 23:40:55 +0000
Received: from sss.pgh.pa.us ([66.207.139.130])
 by magus.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <tgl@sss.pgh.pa.us>) id 1WDjQD-0003Z5-MM
 for pgsql-docs@postgresql.org; Wed, 12 Feb 2014 23:40:55 +0000
Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1])
 by sss.pgh.pa.us (8.14.4/8.14.4) with ESMTP id s1CNePou002470;
 Wed, 12 Feb 2014 18:40:25 -0500
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Peter Eisentraut <peter_e@gmx.net>
cc: Vik Fearing <vik.fearing@dalibo.com>, PG Docs <pgsql-docs@postgresql.org>
Subject: Re: Links for upgraders
In-reply-to: <1392173905.30895.1.camel@vanquo.pezone.net>
References: <52DCC72E.5010009@dalibo.com> <23031.1390203350@sss.pgh.pa.us>
 <52DD4402.8070307@dalibo.com> <1392173905.30895.1.camel@vanquo.pezone.net>
Comments: In-reply-to Peter Eisentraut <peter_e@gmx.net>
 message dated "Tue, 11 Feb 2014 21:58:25 -0500"
Date: Wed, 12 Feb 2014 18:40:25 -0500
Message-ID: <2469.1392248425@sss.pgh.pa.us>
X-Pg-Spam-Score: -2.6 (--)
List-Archive: <http://archives.postgresql.org/pgsql-docs>
List-Help: <mailto:majordomo@postgresql.org?body=help>
List-ID: <pgsql-docs.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@postgresql.org>
List-Post: <mailto:pgsql-docs@postgresql.org>
List-Subscribe: <mailto:majordomo@postgresql.org?body=sub%20pgsql-docs>
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-docs>
X-Mailing-List: pgsql-docs
Precedence: bulk
Sender: pgsql-docs-owner@postgresql.org

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


-- 
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs