Received: from malur.postgresql.org ([217.196.149.56])
 by arkaria.postgresql.org with esmtp (Exim 4.80) (envelope-from
 <pgsql-docs-owner+M7938=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
 id 1WDjnN-0003H6-RX
 for pgsql-docs@arkaria.postgresql.org; Thu, 13 Feb 2014 00:04:50 +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+M7938=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
 id 1WDjnN-0001Us-Am
 for pgsql-docs@arkaria.postgresql.org; Thu, 13 Feb 2014 00:04:49 +0000
Received: from makus.postgresql.org ([2001:4800:7903:4::125])
 by malur.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <jd@commandprompt.com>) id 1WDjnM-0001Uk-BI
 for pgsql-docs@postgresql.org; Thu, 13 Feb 2014 00:04:48 +0000
Received: from lists.commandprompt.com ([69.168.55.30])
 by makus.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <jd@commandprompt.com>) id 1WDjnJ-0008CF-0t
 for pgsql-docs@postgresql.org; Thu, 13 Feb 2014 00:04:47 +0000
Received: from [192.168.1.186] (spinlock.commandprompt.com [69.168.55.30])
 by lists.commandprompt.com (Postfix) with ESMTPA id B414C479;
 Wed, 12 Feb 2014 16:04:42 -0800 (PST)
Received: from [192.168.1.186] ([71.95.106.58] helo=[192.168.1.186]) by
 assp.commandprompt.com with ESMTPS(AES256-SHA) (2.1.1);
 12 Feb 2014 16:04:42 -0800
Message-ID: <52FC0C1A.4080504@commandprompt.com>
Date: Wed, 12 Feb 2014 16:04:42 -0800
From: "Joshua D. Drake" <jd@commandprompt.com>
Organization: Command Prompt, Inc.
User-Agent: Mozilla/5.0 (X11; Linux x86_64;
 rv:24.0) Gecko/20100101 Thunderbird/24.2.0
MIME-Version: 1.0
To: Tom Lane <tgl@sss.pgh.pa.us>, Peter Eisentraut <peter_e@gmx.net>
CC: Vik Fearing <vik.fearing@dalibo.com>, PG Docs <pgsql-docs@postgresql.org>
Subject: Re: Links for upgraders
References: <52DCC72E.5010009@dalibo.com> <23031.1390203350@sss.pgh.pa.us>
 <52DD4402.8070307@dalibo.com> <1392173905.30895.1.camel@vanquo.pezone.net>
 <2469.1392248425@sss.pgh.pa.us>
In-Reply-To: <2469.1392248425@sss.pgh.pa.us>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
X-Assp-Version: 2.1.1(11364) on assp.commandprompt.com
X-Assp-Client-SSL: yes
X-Assp-ID: assp.commandprompt.com m1-49882-09353
X-Assp-Envelope-From: jd@commandprompt.com
X-Assp-Intended-For: tgl@sss.pgh.pa.us
X-Assp-Original-Subject: Re: [DOCS] Links for upgraders
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


On 02/12/2014 03:40 PM, Tom Lane wrote:
> 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.

Not to hijack the thread but after a decade and a half of writing 
release notes one would think that we would have a parser that goes 
through and automatically updates the version number :P

jD

>
> 			regards, tom lane
>
>


-- 
Command Prompt, Inc. - http://www.commandprompt.com/  509-416-6579
PostgreSQL Support, Training, Professional Services and Development
High Availability, Oracle Conversion, Postgres-XC, @cmdpromptinc
For my dreams of your image that blossoms
    a rose in the deeps of my heart. - W.B. Yeats


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