Date: Tue, 27 May 2025 17:27:56 -0400
From: Bruce Momjian <bruce@momjian.us>
To: Joe Conway <mail@joeconway.com>
Cc: =?utf-8?Q?=C3=81lvaro?= Herrera <alvherre@kurilemu.de>,
	Nazir Bilal Yavuz <byavuz81@gmail.com>,
	PostgreSQL-development <pgsql-hackers@lists.postgresql.org>,
	Thomas Munro <thomas.munro@gmail.com>
Subject: Re: PG 18 release notes draft committed
Message-ID: <aDYuXN8gG_oQQD71@momjian.us>
References: <aCyUrG9vu1eDo26b@momjian.us>
 <202505230754.fsspbpqhybqt@alvherre.pgsql>
 <aDB8fjawTe679ZCa@momjian.us>
 <03b04188-02e2-4bd8-b65b-18c3e1cc40c4@joeconway.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <03b04188-02e2-4bd8-b65b-18c3e1cc40c4@joeconway.com>
Archived-At: 
 <https://www.postgresql.org/message-id/aDYuXN8gG_oQQD71%40momjian.us>
Precedence: bulk

On Mon, May 26, 2025 at 10:20:08AM -0400, Joe Conway wrote:
> On 5/23/25 09:47, Bruce Momjian wrote:
> > On Fri, May 23, 2025 at 09:54:54AM +0200, Álvaro Herrera wrote:
> > > I also think that showing an XML-ish format of a commit message is
> > > unhelpful, not to mention hard to read.  Showing a few actual examples
> > > would be better.
> > 
> > Agreed, but the XML came from Joe Conway so I am hesitant to remove it
> > myself without feedback from him.
> 
> 
> I am not married to it, but I would say that I find pure examples
> confusing/ambiguous. To me at least the XML-ish specification is easier to
> understand.
> 
> Perhaps both the specification as-is and one or two examples added?

Yeah, I think some people like syntax, others like examples.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Do not let urgent matters crowd out time for investment in the future.