From: Tom Lane <tgl@sss.pgh.pa.us>
To: Bruce Momjian <bruce@momjian.us>
Cc: Alvaro Herrera <alvherre@2ndquadrant.com>
Cc: Fabien COELHO <coelho@cri.ensmp.fr>
Cc: PostgreSQL-development <pgsql-hackers@postgresql.org>
Subject: Re: PG 13 release notes, first draft
Date: Mon, 11 May 2020 22:23:53 -0400
Message-ID: <11843.1589250233@sss.pgh.pa.us> (raw)
In-Reply-To: <20200512005714.GN4666@momjian.us>
References: <20200512001744.GH4666@momjian.us>
<20200512003456.GA29166@alvherre.pgsql>
<20200512005714.GN4666@momjian.us>
Bruce Momjian <bruce@momjian.us> writes:
> Well, are you suggesting a new section because the glossary shouldn't be
> listed under source code, or because you want the function reformatting
> added? We just need to understand what the purpose is. We already have
> the glossary listed, since that is new and user-visible.
The implication of what you say here is that "is it user-visible?"
is a criterion for whether to release-note something. By that logic
we probably *should* relnote the function table layout changes, because
they sure as heck are user-visible. People might or might not notice
addition of a glossary, but I think just about every user consults
the function/operator tables regularly.
I concur with Alvaro's position that if we are listing documentation
changes, pushing them under "Source Code" is not the way to do it.
That subsection has always been understood to be "stuff you don't
care about if you're not a hacker".
So that sort of leads me to the conclusion that "major documentation
changes" might be a reasonable sub-heading for the release notes.
regards, tom lane
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-hackers@postgresql.org
Cc: tgl@sss.pgh.pa.us, bruce@momjian.us, alvherre@2ndquadrant.com, coelho@cri.ensmp.fr
Subject: Re: PG 13 release notes, first draft
In-Reply-To: <11843.1589250233@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