Re: Adding an explaining title to Notes on SGML

From: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
To: Marcos Pegoraro <marcos(at)f10(dot)com(dot)br>
Cc: Daniel Gustafsson <daniel(at)yesql(dot)se>, PostgreSQL Hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Adding an explaining title to Notes on SGML
Date: 2026-04-23 13:50:31
Message-ID: CAKFQuwa=rtOiZhFkim8-45HyYuexExaO9OSkT4Qqz3hxWKA55w@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Thu, Apr 23, 2026 at 6:34 AM Marcos Pegoraro <marcos(at)f10(dot)com(dot)br> wrote:

> Em qui., 23 de abr. de 2026 às 09:27, David G. Johnston <
> david(dot)g(dot)johnston(at)gmail(dot)com> escreveu:
>
>> Use a footnote, but add entries for any/some to the table and use the
>>> description to say they are not implemented and to use bool_and/bool_or
>>> instead, then anchor the footnote at these entries.
>>>
>>
> Honestly, I'd like to remove all footnotes. The watermark identifying them
> is so small that many people don't even see that it's a link, and the fact
> that it's at the bottom of the page makes it even more isolated from the
> text it refers to.
>

This seems solvable in the xslt/CSS. Instead of traditional superscript
print the link at normal-ish size with normal underline indicator for it
being a link. On the website we could possibly even code in a tooltip on
hover to show the note content without clicking or scrolling the page. And
in this case choosing not to follow the footnote only means one loses out
on understanding why we didn't implement any/some aggregates, not that main
info, which is repeated for each, that they are not implemented. I'd call
that a top-tier example of when to use a footnote. And agree we can do
better styling it.

David J.

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message vignesh C 2026-04-23 13:56:18 Re: StringInfo fixes, v19 edition. Plus a few oddities
Previous Message Álvaro Herrera 2026-04-23 13:49:46 Re: [Patch] Block ALTER TABLE RENAME COLUMN when column is used by property graph