From: Tom Lane <tgl@sss.pgh.pa.us>
To: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
cc: Tatsuo Ishii <ishii@sraoss.co.jp>, pgsql-docs@postgresql.org,
        pgsql-hackers@postgresql.org
Subject: Re: [HACKERS] Questionable tag usage
In-reply-to: <df0fed07-2d9c-561d-c187-0ffcde4274f3@2ndquadrant.com>
References: <20170105.092557.1822243556008160851.t-ishii@sraoss.co.jp>
 <25963.1483591811@sss.pgh.pa.us>
 <cec01422-4977-14b9-a77c-2d779cf83324@2ndquadrant.com>
 <df0fed07-2d9c-561d-c187-0ffcde4274f3@2ndquadrant.com>
Comments: In-reply-to Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
	message dated "Tue, 21 Mar 2017 21:50:42 -0400"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <32519.1490151757.1@sss.pgh.pa.us>
Date: Tue, 21 Mar 2017 23:02:37 -0400
Message-ID: <32520.1490151757@sss.pgh.pa.us>
Precedence: bulk
Sender: pgsql-docs-owner@postgresql.org

Peter Eisentraut <peter.eisentraut@2ndquadrant.com> writes:
>> On 1/4/17 11:50 PM, Tom Lane wrote:
>>> Anyway, bottom line is I'm not terribly excited about fixing just this
>>> one place.  I think we need to decide whether we like the new more-verbose
>>> output for links.  If we don't, we need to fix the markup rules to not do
>>> that.  If we do, there are a lot of places that need adjustment to be less
>>> duplicative, and we should try to be somewhat systematic about fixing
>>> them.

> This question is still open.  Do we want to keep the new linking style
> Section 1.2.3, "Title", or revert back to the old style just Section
> 1.2.3?  It's a simple toggle setting.

I'd vote for reverting for now.  If someone wants to run through the
docs and make considered decisions about where the more verbose style
is a win and where it isn't, then we could make the style change.
But that does not seem like a high-priority task --- and at the moment,
what we've got is a huge pile of docs that were written with the
less verbose style of markup in mind.  So my bet is that there's a lot
of places where more-verbose is not a win.

			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