Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps  (TLS1.3) tls
 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.94.2)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1sXLfO-003S2x-K8
	for pgsql-hackers@arkaria.postgresql.org; Fri, 26 Jul 2024 14:11:30 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.94.2)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1sXLfM-00CMe6-6B
	for pgsql-hackers@arkaria.postgresql.org; Fri, 26 Jul 2024 14:11:28 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
	by malur.postgresql.org with esmtps  (TLS1.3) tls
 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.94.2)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1sXLfL-00CMdx-T3
	for pgsql-hackers@lists.postgresql.org; Fri, 26 Jul 2024 14:11:27 +0000
Received: from sss.pgh.pa.us ([68.162.161.243])
	by magus.postgresql.org with esmtps  (TLS1.3) tls
 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.94.2)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1sXLfJ-001aYZ-DE
	for pgsql-hackers@postgresql.org; Fri, 26 Jul 2024 14:11:27 +0000
Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1])
	by sss.pgh.pa.us (8.15.2/8.15.2) with ESMTP id 46QEBMBD1673966;
	Fri, 26 Jul 2024 10:11:22 -0400
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Daniel Gustafsson <daniel@yesql.se>
cc: Marcos Pegoraro <marcos@f10.com.br>,
        PostgreSQL Hackers <pgsql-hackers@postgresql.org>
Subject: Re: Detailed release notes
In-reply-to: <4D1ACBCD-70AD-4286-8640-6DFC2ED206B8@yesql.se>
References: 
 <CAB-JLwZnhaAcD2g_qxSqP-zcfek8NyOU48qqneeYcjwRODr6YA@mail.gmail.com>
 <F8C2CC64-5265-4668-901D-B4A20420EC89@yesql.se>
 <CAB-JLwYDP58XRTjQFGswBEBHokWSh00NbvFAsAVzSQgDr+hMFg@mail.gmail.com>
 <4D1ACBCD-70AD-4286-8640-6DFC2ED206B8@yesql.se>
Comments: In-reply-to Daniel Gustafsson <daniel@yesql.se>
	message dated "Fri, 26 Jul 2024 15:11:20 +0200"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <1673964.1722003082.1@sss.pgh.pa.us>
Date: Fri, 26 Jul 2024 10:11:22 -0400
Message-ID: <1673965.1722003082@sss.pgh.pa.us>
List-Id: <pgsql-hackers.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-hackers@lists.postgresql.org>
List-Owner: <mailto:pgsql-hackers-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-hackers>
Archived-At: 
 <https://www.postgresql.org/message-id/1673965.1722003082%40sss.pgh.pa.us>
Precedence: bulk

Daniel Gustafsson <daniel@yesql.se> writes:
>> On 26 Jul 2024, at 15:00, Marcos Pegoraro <marcos@f10.com.br> wrote:
>> But why is that just a hidden comment and not a visible link for us ?

> That's likely the wrong level of detail for the overwhelming majority of
> release notes readers.  I have a feeling this was discussed not too long ago
> but (if so) I fail to find that discussion now.

Yeah, I too recall some discussion of surfacing the commit links
somehow, perhaps as a popup tooltip.  Nobody's got round to it yet.
It's not real clear how to handle multiple links per <para>, which
happens from time to time in major release notes and just about
everyplace in minor release notes.

			regards, tom lane