Re: Links for upgraders

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Vik Fearing <vik(dot)fearing(at)dalibo(dot)com>
Cc: PG Docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Links for upgraders
Date: 2014-01-20 07:35:50
Message-ID: 23031.1390203350@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Vik Fearing <vik(dot)fearing(at)dalibo(dot)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

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Alan B 2014-01-20 11:50:47 Re: Add clarification example to EXEC SQL CONNECT with password
Previous Message Vik Fearing 2014-01-20 06:50:22 Links for upgraders