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@momjian.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@alvh.no-ip.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.