Date: Mon, 8 Jun 2026 10:13:33 -0400
From: Bruce Momjian <bruce@momjian.us>
To: =?utf-8?Q?=C3=81lvaro?= Herrera <alvherre@kurilemu.de>
Cc: Yugo Nagata <nagata@sraoss.co.jp>,
	PostgreSQL-development <pgsql-hackers@lists.postgresql.org>
Subject: Re: First draft of PG 19 release notes
Message-ID: <aibODYK-IYODcxoe@momjian.us>
References: <aiMcYbhya9eqF4Zr@momjian.us>
 <aiQPgZtALNqj4npv@alvherre.pgsql>
 <aiY6VAG36CPzfq0l@momjian.us>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <aiY6VAG36CPzfq0l@momjian.us>
Archived-At: 
 <https://www.postgresql.org/message-id/aibODYK-IYODcxoe%40momjian.us>
Precedence: bulk

On Sun, Jun  7, 2026 at 11:43:16PM -0400, Bruce Momjian wrote:
> > * In section E.1.3.1.1 Optimizer, I think the item
> >   "Allow extended statistics on virtual generated columns"
> >   should come before all other items, because it's the only one that
> >   requires user action in order for them to take advantage of it.  All
> >   the other items refer to some optimization that occurs automatically.
> 
> While the first item in each section is the most important, I then list
> later items in groups that have similar characteristics, which I think
> simplifies reading.  While I could order all items in importance order,
> I think it would be much more confusing to read.  Right now the item you
> mention is in a group of items about optimizer statistics.

Actually, if there is no "most important" item in a section, I just
order by placing the largest group of similar items first.  Here are the
detais:

	https://wiki.postgresql.org/wiki/Creating_Major_Release_Notes
	order inside of sections
	               most important item first in section
	                  if none, then largest group first
	               group similar items together
	               order group by item importance
	               ideally the last item in a group will relate to the first item in the next group

-- 
  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.