Re: Detailed release notes

From: Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>
To: Bruce Momjian <bruce(at)momjian(dot)us>
Cc: Marcos Pegoraro <marcos(at)f10(dot)com(dot)br>, jian he <jian(dot)universality(at)gmail(dot)com>, Jelte Fennema-Nio <postgres(at)jeltef(dot)nl>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Daniel Gustafsson <daniel(at)yesql(dot)se>, PostgreSQL Hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Detailed release notes
Date: 2024-09-17 08:12:44
Message-ID: 202409170812.mfwjjmujjxly@alvherre.pgsql
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: 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/

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Alvaro Herrera 2024-09-17 08:19:29 Re: First draft of PG 17 release notes
Previous Message Jelte Fennema-Nio 2024-09-17 08:01:28 Re: First draft of PG 17 release notes