Feedback-ID: ia2694551:Fastmail
Date: Tue, 17 Sep 2024 10:12:44 +0200
From: Alvaro Herrera <alvherre@alvh.no-ip.org>
To: Bruce Momjian <bruce@momjian.us>
Cc: Marcos Pegoraro <marcos@f10.com.br>,
	jian he <jian.universality@gmail.com>,
 Jelte Fennema-Nio <postgres@jeltef.nl>,
	Tom Lane <tgl@sss.pgh.pa.us>, Daniel Gustafsson <daniel@yesql.se>,
	PostgreSQL Hackers <pgsql-hackers@postgresql.org>
Subject: Re: Detailed release notes
Message-ID: <202409170812.mfwjjmujjxly@alvherre.pgsql>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <ZuiEh_O2TYO1agfi@momjian.us>
Archived-At: 
 <https://www.postgresql.org/message-id/202409170812.mfwjjmujjxly%40alvherre.pgsql>
Precedence: bulk

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/