Re: Detailed release notes

On 18.09.24 02:54, Bruce Momjian wrote:
> 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.

Maybe this shouldn't be done between RC1 and GA. This is clearly a more
complex topic that should go through a proper review and testing cycle.