Re: Detailed release notes

On Jul 26, 2024, at 9:26 AM, Marcos Pegoraro <marcos(at)f10(dot)com(dot)br> wrote:




Em sex., 26 de jul. de 2024 às 10:11, Daniel Gustafsson <daniel(at)yesql(dot)se> escreveu:

That's likely the wrong level of detail for the overwhelming majority of

release notes readers.  I have a feeling this was discussed not too long ago

but (if so) I fail to find that discussion now.

Wrong level ? Where is the appropriate place on DOCs to see exactly what I'll get when updated ? 


A separate page "Detailed Release Notes" ? I don't think so.


I think release notes are sometimes the only place we read to decide if an upgrade is doable or not.

Well, that opened my eyes, now I can see detailed info about every feature when it's committed.


And I'm really convinced that a small link to that commit wouldn't get dirty release notes.

FWIW, pgPedia has a version of the release notes that does get that granular:

https://pgpedia.info/postgresql-versions/postgresql-17.html

Jonathan