Re: Detailed release notes - Mailing list pgsql-hackers

From Alvaro Herrera
Subject Re: Detailed release notes
Date
Msg-id 202409170812.mfwjjmujjxly@alvherre.pgsql
Whole thread Raw
In response to Re: Detailed release notes  (Bruce Momjian <bruce@momjian.us>)
Responses Re: Detailed release notes
Re: Detailed release notes
List pgsql-hackers
On 2024-Sep-16, Bruce Momjian wrote:

> We could try:
> 
>    Add backend support for injection points (Michael Paquier) §1 §2 §3 §4
> 
> and maybe only add numbers if there is more than one commit.

Well, this reads like references to sections 1, 2, 3 and 4, but they
aren't that, and probably such sections don't even exist.  I think the
use of the section symbol is misleading and typographically wrong.
https://www.monotype.com/resources/punctuation-series-section-sign


Maybe it would work to use numbers in square brackets instead:

    Add backend support for injection points (Michael Paquier) [1] [2] [3] [4]

Maybe use the word "commit" for the first one, which would make it
clearer what the links are about:

    Add backend support for injection points (Michael Paquier) [commit 1] [2] [3] [4]

and if there's only one, say just "[commit]".

-- 
Álvaro Herrera         PostgreSQL Developer  —  https://www.EnterpriseDB.com/



pgsql-hackers by date:

Previous
From: Jelte Fennema-Nio
Date:
Subject: Re: First draft of PG 17 release notes
Next
From: Alvaro Herrera
Date:
Subject: Re: First draft of PG 17 release notes