Re: PG 18 release notes draft committed

On 5/29/25 07:53, Álvaro Herrera wrote:
> On 2025-May-28, Bruce Momjian wrote:
> 
>> Sure, we can just link to:
>> 
>>     https://www.postgresql.org/list/pgsql-committers/
>> 
>> and they can choose any recent commit.
> 
> IMO this is useless, because there's no assurance that the "recent
> commit" they choose is actually following good practices.

My intent was to pick some specific examples that we agree are good 
ones, not this.

>> > Also, looking at the wiki page, my inclination would be to add an
>> > "Examples" section at the bottom of the wiki page -- does that work
>> > or do you think it ought to go just under the "General layout"
>> > syntax section?
> 
> I think we ought to show examples of each rules we're talking about in
> each section.

That could be useful too, but I think complete examples are still good 
to have.

-- 
Joe Conway
PostgreSQL Contributors Team
RDS Open Source Databases
Amazon Web Services: https://aws.amazon.com