Re: Enhancement request for patch release announcements and READMEs

On Sat, Sep 5, 2026 at 11:57:54AM -0400, Tom Lane wrote:
> Adrian Klaver <adrian(dot)klaver(at)aklaver(dot)com> writes:
> > On 9/5/26 3:37 AM, Michael Verheij wrote:
> >> As a new PostgreSQL DBA I struggle with getting a list of all post-
> >> installation instructions for patches. Is it possible to have a section
> >> in the README stating what has to be done against the PostgreSQL cluster
> >> to apply database-related actions after a patch has been installed?
>
> > As to previous patch announcements:
> > https://www.postgresql.org/docs/release/
>
> We (I) put very substantial effort into migration instructions for
> minor releases. Right now, the best way to view those is in the
> main documentation, eg for 17.11 see
>
> https://www.postgresql.org/docs/17/release-17-11.html#RELEASE-17-11-MIGRATION
>
> and then, if you skipped any minor releases, follow the breadcrumb
> links to previous minors that had noteworthy migration issues.
>
> The release-notes-only archive that Adrian mentions ought to be
> the same text, but for some reason it's rendering without the
> subsection headings, which at least IMO makes it a lot less
> readable for this purpose.
>
> (And that bad rendering *is* a fit subject for this list ...
> anyone wanna fix it?)

This blog entry about which release notes to read might help you:

https://momjian.us/main/blogs/pgblog/2022.html#June_13_2022

--
Bruce Momjian <bruce(at)momjian(dot)us> https://momjian.us
EDB https://enterprisedb.com

Do not let urgent matters crowd out time for investment in the future.