Re: Detailed release notes - Mailing list pgsql-hackers

From Bruce Momjian
Subject Re: Detailed release notes
Date
Msg-id Zuok41N0mw6OPVm7@momjian.us
Whole thread Raw
In response to Re: Detailed release notes  (Tom Lane <tgl@sss.pgh.pa.us>)
Responses Re: Detailed release notes
Re: Detailed release notes
Re: Detailed release notes
List pgsql-hackers
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.

-- 
  Bruce Momjian  <bruce@momjian.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?"



pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: Detailed release notes
Next
From: shawn wang
Date:
Subject: Re: Trim the heap free memory