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 1sgAaj-00GBUW-Fu
	for pgsql-hackers@arkaria.postgresql.org; Mon, 19 Aug 2024 22:11:09 +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 1sgAag-003UOn-KC
	for pgsql-hackers@arkaria.postgresql.org; Mon, 19 Aug 2024 22:11:07 +0000
Received: from makus.postgresql.org ([2001:4800:3e1:1::229])
	by malur.postgresql.org with esmtps  (TLS1.3) tls
 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.94.2)
	(envelope-from <bruce@momjian.us>)
	id 1sgAag-003UO2-AA
	for pgsql-hackers@lists.postgresql.org; Mon, 19 Aug 2024 22:11:06 +0000
Received: from momjian.us ([72.94.173.45])
	by makus.postgresql.org with esmtps  (TLS1.3) tls
 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.94.2)
	(envelope-from <bruce@momjian.us>)
	id 1sgAaa-000T6t-Ct
	for pgsql-hackers@postgresql.org; Mon, 19 Aug 2024 22:11:05 +0000
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=momjian.us;
	s=2024011501; h=In-Reply-To:Content-Type:MIME-Version:References:Message-ID:
	Subject:Cc:To:From:Date:Sender:Reply-To:Content-Transfer-Encoding:Content-ID:
	Content-Description; bh=UHZmuzX1paqidPWUKlDaUkjgVOu9rfh9zP9SkkvYhN4=; b=NYp0/
	UKnXfSgWaAxsATbmXE29BhgooLFnoqt2ALzuWUYjtQaQaeT4T0uLiEKMEqSfUwXaqedsYuLlbEY1P
	yAmMTIfUsK38EGaKIUBpdq5HtblIB9vdBATUHYTPlAB6okZarFtm9lYuPpYNjut/BPpzefbNFjf7J
	gXtlaycyuwKZj+eW+atiJfqdZMELZb3AKHM5hYtkA12NLN5wDe8/nKnmw8zXqvm0Wgwh7ZgwfuBz8
	Xg1hpimHa0jOaUZsSjw5WYlbTP/4MP/eTa95PXQNKWk2JyOPolAk2hOgC21Fk+vgOslj/33GzQ/f8
	LXWCvmdWtcvA/7LhYPz4EB+3PjQZA==;
Received: from bruce by momjian.us with local (Exim 4.96)
	(envelope-from <bruce@momjian.us>)
	id 1sgAaW-00DssB-2l;
	Mon, 19 Aug 2024 18:10:56 -0400
Date: Mon, 19 Aug 2024 18:10:56 -0400
From: Bruce Momjian <bruce@momjian.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Daniel Gustafsson <daniel@yesql.se>,
	Marcos Pegoraro <marcos@f10.com.br>,
	PostgreSQL Hackers <pgsql-hackers@postgresql.org>
Subject: Re: Detailed release notes
Message-ID: <ZsPC8FoTFeW9PP0n@momjian.us>
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>
 <1673965.1722003082@sss.pgh.pa.us>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <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/ZsPC8FoTFeW9PP0n%40momjian.us>
Precedence: bulk

On Fri, Jul 26, 2024 at 10:11:22AM -0400, Tom Lane wrote:
> 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.

Yes, some kind of popup is what I remember.  Looking at the HTML output
for the docs, the SGML comments don't appear the HTML, so I think we
need to write a Perl or shell script to match all the SGML <listitem>
comment text with the HTML <li> text, and insert tooltip text with links
for every one of them.  Should I work on this?

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Only you can decide what is important to you.