public inbox for [email protected]
help / color / mirror / Atom feedFrom: Daniel Gustafsson <[email protected]>
To: Marcos Pegoraro <[email protected]>
Cc: PostgreSQL Hackers <[email protected]>
Subject: Re: Adding an explaining title to Notes on SGML
Date: Thu, 23 Apr 2026 09:55:28 +0200
Message-ID: <[email protected]> (raw)
In-Reply-To: <CAB-JLwY4izzCHDjS=Xb0KMc7uXbg6JjuMdRA2ri2CqYbeMDMEw@mail.gmail.com>
References: <CAB-JLwY4izzCHDjS=Xb0KMc7uXbg6JjuMdRA2ri2CqYbeMDMEw@mail.gmail.com>
> On 22 Apr 2026, at 20:59, Marcos Pegoraro <[email protected]> wrote:
>
> I noticed that a "This" was missing when reading the Notes of the Aggregates page, so I thought... wouldn't it be better if we had a title in some of the Notes ?
> Because in many cases, like this example, you have a huge table and below it a Notes. But what is this Notes talking about ?
Notes are IMHO useful when they cause the reader to reflect on the <para> they
just read.
I think it's an antipattern to have notes so far removed from the relevant
<para> that we need a title for it. A reader looking for info on count() will
find it in the table and read it - we can't really expect them to keep
scrolling a few pages down to see if there might be more info that wasn't
linked to.
Wouldn't it make more sense to refactor to move the information in the note
closer to what the note is regarding?
--
Daniel Gustafsson
view thread (8+ messages) latest in thread
reply
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: [email protected]
Cc: [email protected], [email protected]
Subject: Re: Adding an explaining title to Notes on SGML
In-Reply-To: <[email protected]>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox