Feedback-ID: i131946ab:Fastmail
Message-ID: <6f9cc655-04a7-6d95-4cfe-46c1ec8ca70e@enterprisedb.com>
Date: Wed, 29 Jun 2022 13:33:08 +0100
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:91.0)
 Gecko/20100101 Thunderbird/91.10.0
Subject: Re: proposal: convert comments in documents to html comments
Content-Language: en-US
To: Noboru Saito <noborusai@gmail.com>, Michael Paquier <michael@paquier.xyz>
Cc: Alvaro Herrera <alvherre@alvh.no-ip.org>, Peter Geoghegan <pg@bowt.ie>,
 Tom Lane <tgl@sss.pgh.pa.us>, Pg Docs <pgsql-docs@lists.postgresql.org>
References: 
 <CAAM3qnJDsT6y6t7KY=0VCtrG=uQtNuBdhiUk3vor530WbpPsFA@mail.gmail.com>
 <20220627084839.5fuankjxgt6m62vv@alvherre.pgsql>
 <CAAM3qn+QtUWDZWbiM895b70YSttm+_UkUK=WjxAsh4ou-QMDhQ@mail.gmail.com>
 <Yrp7zoI2aKpUxqu8@paquier.xyz>
 <CAAM3qnK+GT=7g8dRvPPZcn_GbAYfQg47K+0FC2kfid7cEG8F-w@mail.gmail.com>
From: Peter Eisentraut <peter.eisentraut@enterprisedb.com>
In-Reply-To: 
 <CAAM3qnK+GT=7g8dRvPPZcn_GbAYfQg47K+0FC2kfid7cEG8F-w@mail.gmail.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
Archived-At: 
 <https://www.postgresql.org/message-id/6f9cc655-04a7-6d95-4cfe-46c1ec8ca70e%40enterprisedb.com>
Precedence: bulk

On 29.06.22 09:29, Noboru Saito wrote:
> Comments aren't really associated with anything, so it's difficult to
> associate them correctly.
> 
> I think it is better to stop commenting xml (sgml) and format it as
> follows (tags are tentative).

Yeah, with the exception of the release notes, XML comments were written 
with the understanding that they are source-level comments, not 
something that gets forwarded to the output.  So let's leave comments be 
comments, and if there is anything we want to include in the output, 
let's mark it up properly.