Re: Do we ever edit release notes after release to add warnings about incompatibilities? - Mailing list pgsql-hackers

From Magnus Hagander
Subject Re: Do we ever edit release notes after release to add warnings about incompatibilities?
Date
Msg-id CABUevEzfw-gNv3kax-=wV5aD5F-kxJEEsqd0mm_d4Of9rTp87w@mail.gmail.com
Whole thread Raw
In response to Do we ever edit release notes after release to add warnings about incompatibilities?  (Greg Stark <stark@mit.edu>)
List pgsql-hackers
On Fri, Feb 21, 2020 at 10:15 PM Greg Stark <stark@mit.edu> wrote:
>
> So last year in 10.5, 9.6.10, 9.5.9, 9.4.19, and 9.3.24 we had a
> binary ABI break that caused pglogical and other logical decoding
> plugins to break:
>
> https://github.com/2ndQuadrant/pglogical/issues/183#issuecomment-417558313
>
> This wasn't discovered until after the release so the release notes
> don't highlight the risk. Someone upgrading past this release now
> could diligently read all the release notes for all the versions they
> care about and would never see anything warning that there was an
> unintentional ABI break.
>
> I wonder if we shouldn't be adding a note to those release notes after
> the fact (and subsequent "However if you are upgrading from a version
> earliers than...." notes in later releases). It would be quite a pain
> I'm sure but I don't see any other way to get the information to
> someone upgrading in the future. I suppose we could just add the note
> to the current release notes on the theory that we only support
> installing the current release.
>

I definitely think we should. People will be looking at the release
notes for many years to come... And people will be installing the old
versions.

I think the right thing to do is to add them in the same place as they
would've been added if we had noticed the thing at the right time. We
shouldn't duplicate it across every notes since then, but it should be
back-patched into those.

//Magnus



pgsql-hackers by date:

Previous
From: Greg Stark
Date:
Subject: Do we ever edit release notes after release to add warnings about incompatibilities?
Next
From: Tom Mercha
Date:
Subject: Re: SPI Concurrency Precautions? Problems with Parallel Execution ofMultiple CREATE TABLE statements