Re: First draft of the PG 15 release notes

From: David Steele <david(at)pgmasters(dot)net>
To: Ian Lawrence Barwick <barwick(at)gmail(dot)com>, Bruce Momjian <bruce(at)momjian(dot)us>
Cc: PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: First draft of the PG 15 release notes
Date: 2022-05-12 12:33:10
Message-ID: 0221fbf8-faeb-774f-291d-647e3480dfe3@pgmasters.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On 5/11/22 10:50 PM, Ian Lawrence Barwick wrote:
> 2022年5月12日(木) 11:46 Bruce Momjian <bruce(at)momjian(dot)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(at)pgmasters(dot)net

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Euler Taveira 2022-05-12 12:48:28 Re: Privileges on PUBLICATION
Previous Message Ajin Cherian 2022-05-12 11:32:48 Re: First draft of the PG 15 release notes