Subject: Re: Add A Glossary
To: Alvaro Herrera <alvherre@2ndquadrant.com>,
 Corey Huinker <corey.huinker@gmail.com>
References: <20200320001122.GA19602@alvherre.pgsql>
Cc: =?UTF-8?Q?J=c3=bcrgen_Purtz?= <juergen@purtz.de>,
 Roger Harkavy <rogerharkavy@gmail.com>, pgsql-hackers@postgresql.org,
 Fabien COELHO <coelho@cri.ensmp.fr>, Michael Paquier <michael@paquier.xyz>
From: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
Organization: 2ndQuadrant
Message-ID: <9a00fad7-bf0c-8217-29a8-3bb2b9476eec@2ndquadrant.com>
Date: Tue, 24 Mar 2020 19:26:52 +0100
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:52.0)
 Gecko/20100101 Thunderbird/52.9.1
MIME-Version: 1.0
In-Reply-To: <20200320001122.GA19602@alvherre.pgsql>
Content-Type: text/plain; charset=windows-1252; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: 7bit
Precedence: bulk

On 2020-03-20 01:11, Alvaro Herrera wrote:
> I gave this a look.  I first reformatted it so I could read it; that's
> 0001.  Second I changed all the long <link> items into <xref>s, which
> are shorter and don't have to repeat the title of the refered to page.
> (Of course, this changes the link to be in the same style as every other
> link in our documentation; some people don't like it. But it's our
> style.)

AFAICT, all the <link> elements in this patch should be changed to <xref>.

If there is something undesirable about the output style, we can change 
that, but it's not this patch's job to make up its own rules.

-- 
Peter Eisentraut              http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services