From: Tom Lane <tgl@sss.pgh.pa.us>
To: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
Cc: Tatsuo Ishii <ishii@sraoss.co.jp>
Cc: pgsql-docs@postgresql.org
Cc: pgsql-hackers@postgresql.org
Subject: Re: [HACKERS] Questionable tag usage
Date: Tue, 21 Mar 2017 23:02:37 -0400
Message-ID: <32520.1490151757@sss.pgh.pa.us> (raw)
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>
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-docs>
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
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: tgl@sss.pgh.pa.us, peter.eisentraut@2ndquadrant.com, ishii@sraoss.co.jp, pgsql-hackers@postgresql.org
Subject: Re: [HACKERS] Questionable tag usage
In-Reply-To: <32520.1490151757@sss.pgh.pa.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox