Received: from malur.postgresql.org ([217.196.149.56])
 by arkaria.postgresql.org with esmtp (Exim 4.80) (envelope-from
 <pgsql-docs-owner+M7898=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
 id 1W59Ou-00080p-Bl
 for pgsql-docs@arkaria.postgresql.org; Mon, 20 Jan 2014 07:36:04 +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+M7898=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
 id 1W59Ot-0002DJ-4O
 for pgsql-docs@arkaria.postgresql.org; Mon, 20 Jan 2014 07:36:03 +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 1W59Os-0002DD-JJ
 for pgsql-docs@postgresql.org; Mon, 20 Jan 2014 07:36:02 +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 1W59Oq-0007yg-7Q
 for pgsql-docs@postgresql.org; Mon, 20 Jan 2014 07:36:02 +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 s0K7ZogH023032;
 Mon, 20 Jan 2014 02:35:50 -0500
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Vik Fearing <vik.fearing@dalibo.com>
cc: PG Docs <pgsql-docs@postgresql.org>
Subject: Re: Links for upgraders
In-reply-to: <52DCC72E.5010009@dalibo.com>
References: <52DCC72E.5010009@dalibo.com>
Comments: In-reply-to Vik Fearing <vik.fearing@dalibo.com>
 message dated "Mon, 20 Jan 2014 07:50:22 +0100"
Date: Mon, 20 Jan 2014 02:35:50 -0500
Message-ID: <23031.1390203350@sss.pgh.pa.us>
X-Pg-Spam-Score: -2.5 (--)
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

Vik Fearing <vik.fearing@dalibo.com> writes:
> The attached patch aims to help upgraders find the relevant information
> important to their upgrade.

This seems like a good idea, but bad implementation.

Why didn't you follow the existing style for the major-version links?
That is, a pattern like

    However, if you are upgrading from a version earlier than 9.0.6,
    see <xref linkend="release-9-0-6">.

What you've got is not just inconsistent with that nearby usage, but
redundant (especially in the plain-text output format) and bad grammar.

			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