Re: Links for upgraders - Mailing list pgsql-docs

From Tom Lane
Subject Re: Links for upgraders
Date
Msg-id 23031.1390203350@sss.pgh.pa.us
Whole thread Raw
In response to Links for upgraders  (Vik Fearing <vik.fearing@dalibo.com>)
Responses Re: Links for upgraders  (Vik Fearing <vik.fearing@dalibo.com>)
List pgsql-docs
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


pgsql-docs by date:

Previous
From: Vik Fearing
Date:
Subject: Links for upgraders
Next
From: Alan B
Date:
Subject: Re: Add clarification example to EXEC SQL CONNECT with password