Message-ID: <0221fbf8-faeb-774f-291d-647e3480dfe3@pgmasters.net>
Date: Thu, 12 May 2022 08:33:10 -0400
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:91.0)
 Gecko/20100101 Thunderbird/91.9.0
Subject: Re: First draft of the PG 15 release notes
Content-Language: en-US
To: Ian Lawrence Barwick <barwick@gmail.com>, Bruce Momjian <bruce@momjian.us>
Cc: PostgreSQL-development <pgsql-hackers@postgresql.org>
References: <YnqIT8kpiO3m6SD7@momjian.us>
 <CAB8KJ=jmLBMAmxjcew12-yntb7m3FH-8A2+Qb7+RybZp1w9GOg@mail.gmail.com>
 <Ynxqf4PxtbP7UtLH@momjian.us>
 <CAB8KJ=j9VhsFXuN+xv5qzxQV7gj-6TKqqwVLSgz5zU7F8nHCYw@mail.gmail.com>
 <Ynx1AzF+YN4FOv6q@momjian.us>
 <CAB8KJ=gx7VZuo22C-ouOH_=b_XcNX7q2gsVvx+jdqCZOvtVn7g@mail.gmail.com>
From: David Steele <david@pgmasters.net>
In-Reply-To: 
 <CAB8KJ=gx7VZuo22C-ouOH_=b_XcNX7q2gsVvx+jdqCZOvtVn7g@mail.gmail.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit
Archived-At: 
 <https://www.postgresql.org/message-id/0221fbf8-faeb-774f-291d-647e3480dfe3%40pgmasters.net>
Precedence: bulk

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