Date: Tue, 14 May 2024 20:39:29 -0400
From: Bruce Momjian <bruce@momjian.us>
To: Andrew Dunstan <andrew@dunslane.net>
Cc: PostgreSQL-development <pgsql-hackers@postgresql.org>
Subject: Re: First draft of PG 17 release notes
Message-ID: <ZkQEQSImTMrZ3F6V@momjian.us>
References: <ZjxLJpnH4VMkOMmi@momjian.us>
 <58757e3e-4ac7-488f-8556-34aa6430c225@dunslane.net>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <58757e3e-4ac7-488f-8556-34aa6430c225@dunslane.net>
Archived-At: <https://www.postgresql.org/message-id/ZkQEQSImTMrZ3F6V%40momjian.us>
Precedence: bulk

On Sat, May 11, 2024 at 03:32:55PM -0400, Andrew Dunstan wrote:
> 
> On 2024-05-09 Th 00:03, Bruce Momjian wrote:
> > I have committed the first draft of the PG 17 release notes;  you can
> > see the results here:
> > 
> > 	https://momjian.us/pgsql_docs/release-17.html
> > 
> > It will be improved until the final release.  The item count is 188,
> > which is similar to recent releases:
> > 
> > 	release-10:  189
> > 	release-11:  170
> > 	release-12:  180
> > 	release-13:  178
> > 	release-14:  220
> > 	release-15:  184
> > 	release-16:  206
> > 	release-17:  188
> > 
> > I welcome feedback.  For some reason it was an easier job than usual.
> 
> 
> I don't like blowing my own horn but I feel commit 3311ea86ed "Introduce a
> non-recursive JSON parser" should be in the release notes. This isn't
> something that's purely internal, but it could be used by an extension or a
> client program to parse JSON documents that are too large to handle with the
> existing API.
> 
> Maybe "Introduce an incremental JSON parser" would have been a better
> headline.

Well, this gets into a level of detail that is beyond the average
reader.  I think at that level people will need to read the git logs or
review the code.  Do we use it for anything yet?

It could be put in the source code section but I try to only have
user-visible stuff there.

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

  Only you can decide what is important to you.