Horton

Re: First draft of the PG 15 release notes

David Steele <david@pgmasters.net>

View thread View on postgr.es
From: David Steele <david@pgmasters.net>
To: Ian Lawrence Barwick <barwick@gmail.com>, Bruce Momjian <bruce@momjian.us>
Cc: PostgreSQL-development <pgsql-hackers@postgresql.org>
Date: 2022-05-12T12:33:10Z
Lists: pgsql-hackers 
On 5/11/22 10:50 PM, Ian Lawrence Barwick wrote:
> 2022年5月12日(木) 11:46 Bruce Momjian <bruce@momjian.us>:
>>
>> On Thu, May 12, 2022 at 11:40:17AM +0900, Ian Lawrence Barwick wrote:
>>> Looking at the release notes from the point of view of someone who has maybe
>>> not been following the long-running debate on removing exclusive backups:
>>>
>>> "Important-sounding backup thing is suddenly gone! What was that
>>> again? Hmm, can't
>>> find anything in the now-current Pg 15 docs [*], do I need to worry
>>> about this!?"
>>>
>>> [*] the backup section has removed all mention of the word "exclusive"
>>> https://www.postgresql.org/docs/devel/continuous-archiving.html#BACKUP-LOWLEVEL-BASE-BACKUP
>>>
>>> versus:
>>>
>>> "Long-deprecated thing is finally gone, ah OK whatever".
>>>
>>> I am thinking back here to a point in my working life where the
>>> release notes were reviewed
>>> (by a team including non-Pg specialists) for potential issues when
>>> considering a major
>>> upgrade - from experience the more clarity with this kind of change
>>> the better so
>>> as not to unnecessarily raise alarm bells.
>>
>> Ah, you are right.  I thought I had "deprecated" in the text, but I now
>> see I did not, and we do have cases where we mention the deprecated
>> status in previous release notes, so the new text is:
>>
>>          Remove long-deprecated exclusive backup mode (David Steele, Nathan
>>          Bossart)
> 
> 
> That works, thanks!

A bit late to this conversation, but +1 from me.

-- 
-David
david@pgmasters.net

Commits

  1. Doc: last minute adjustment to the release notes

  2. Doc: more tweaking of v15 release notes.

  3. Doc: further adjust notes about pg_upgrade_output.d.

  4. Doc: add list of major features to the v15 release notes.

  5. relnotes: update item about public schema permission change

  6. relnotes: update ordered partition scan item

  7. relnotes: add Heikki to UTF8 item

  8. relnotes: improve UTF8 text item in relation to ASCII

  9. relnotes: add null logical replication item

  10. relnotes: adjust several logical replication items and FK text

  11. relnotes: mention non-exclusive backup mode was deprecated

  12. relnotes: add author to in-memory sorts item

  13. relnotes: update for non-exclusive backup mode removal

  14. relnote: improve sorting entries

  15. relnotes: adjustments from Álvaro Herrera

  16. relnotes: update foreign key partition and add sort items

  17. relnotes: more adjustments

  18. relnotes: logical replication permissions checked by subscrib.

  19. relnotes: adjustments

  20. relnotes: remove sequence replication and update 'postgres -C'

  21. relnote: extensive updates

  22. relnotes: "training" -> "trailing"

  23. Standardize references to Zstandard as <productname>

  24. pgstat: Update docs to match the shared memory stats reality.

  25. Raise a WARNING for missing publications.

  26. Skip empty transactions for logical replication.

  27. Optionally disable subscriptions on error.

  28. Allow root-owned SSL private keys in libpq, not only the backend.

  29. Use COPY FREEZE in pgbench for faster benchmark table population.