Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256)
	(Exim 4.89)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1hpZ1S-0006BE-MB
	for pgsql-docs@arkaria.postgresql.org; Mon, 22 Jul 2019 14:10:38 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.89)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1hpZ0T-0003sA-EG
	for pgsql-docs@arkaria.postgresql.org; Mon, 22 Jul 2019 14:09:37 +0000
Received: from makus.postgresql.org ([2001:4800:3e1:1::229])
	by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256)
	(Exim 4.89)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1hpZ0T-0003s3-45
	for pgsql-docs@lists.postgresql.org; Mon, 22 Jul 2019 14:09:37 +0000
Received: from sss.pgh.pa.us ([66.207.139.130])
	by makus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256)
	(Exim 4.92)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1hpZ0Q-0006h4-Lh
	for pgsql-docs@lists.postgresql.org; Mon, 22 Jul 2019 14:09:36 +0000
Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1])
	by sss.pgh.pa.us (8.14.4/8.14.4) with ESMTP id x6ME9VrI023575;
	Mon, 22 Jul 2019 10:09:31 -0400
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
cc: Daniel Gustafsson <daniel@yesql.se>, pgsql-docs@lists.postgresql.org
Subject: Re: Formatting of warning about using ident
In-reply-to: <05d9e235-118f-2dbc-95c3-e1a51c19dad1@2ndquadrant.com>
References: <B20006D2-AE84-40CE-97DE-A607A0027EE0@yesql.se>
 <bc0f78d9-c7e5-1804-9cc1-2fe30f16d2a2@2ndquadrant.com>
 <D7DCADB0-D7E7-4C1B-ACFD-7C1AD466EFE5@yesql.se>
 <05d9e235-118f-2dbc-95c3-e1a51c19dad1@2ndquadrant.com>
Comments: In-reply-to Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
	message dated "Mon, 22 Jul 2019 14:23:12 +0200"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <23573.1563804571.1@sss.pgh.pa.us>
Date: Mon, 22 Jul 2019 10:09:31 -0400
Message-ID: <23574.1563804571@sss.pgh.pa.us>
List-Id: <pgsql-docs.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-docs@lists.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-docs>
Precedence: bulk

Peter Eisentraut <peter.eisentraut@2ndquadrant.com> writes:
> In general, I would argue in favor of fewer "note", "warning", etc.
> Some documentation pages are now just a sequence of "note"s and little
> proper text.  If the normal text properly explains a topic and its pros
> and cons, then we don't need all that extra decoration and it makes the
> text easier to read.

+1.  With the way these things are rendered in the current HTML output,
they are so visually distracting that they ought to be reserved for
absolutely critical info.  I almost feel that we should ban <note>
entirely, because the rendering is completely disproportional to the
meaning.

(Or, maybe, somebody could tinker with the stylesheets?)

			regards, tom lane