> 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
