Re: Detailed release notes

On Tue, Sep 17, 2024 at 08:22:41PM -0400, Tom Lane wrote:
> Bruce Momjian <bruce(at)momjian(dot)us> writes:
> > On Tue, Sep 17, 2024 at 03:29:54PM -0300, Marcos Pegoraro wrote:
> >> Em ter., 17 de set. de 2024 às 05:12, Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>
> >>> Add backend support for injection points (Michael Paquier) [commit 1] [2]
>
> > I think trying to add text to each item is both redundant and confusing,
>
> Also very clutter-y. I'm not convinced that any of this is a good
> idea that will stand the test of time: I estimate that approximately
> 0.01% of people who read the release notes will want these links.

Yes, I think 0.01% is accurate.

> But if we keep it I think the annotations have to be very unobtrusive.

I very much agree.

> (Has anyone looked at the PDF rendering of this? It seems rather
> unfortunate to me.)

Oh, not good. See my build:

https://momjian.us/expire/postgres-US.pdf#page=2890

Those numbers are there because all external links get numbers that
start a 1 at the top of the section and increment for every link --- I
have no idea why. You can see that acronyms that have external links
have the same numbering:

https://momjian.us/expire/postgres-US.pdf#page=3150

I wonder if we should remove the numbers in both cases.

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

When a patient asks the doctor, "Am I going to die?", he means
"Am I going to die soon?"