Thread

Re: Get rid of "Section.N.N.N" on DOCs

Tom Lane <tgl@sss.pgh.pa.us> — 2025-12-28T17:15:28Z

Peter Eisentraut <peter@eisentraut.org> writes:
> On 21.12.25 11:55, Marcos Pegoraro wrote:
>> Now we have - "Section 23.3.1"
>> Changing back that commit will show - "Section 23.3.1, “Supported 
>> Character Sets”."
>> But we want only - "Supported Character Sets"

> Personally, I don't want that.  I think changing to section number plus 
> title could have some merit, but just the title seems inferior to me. 
> But that's just me.

I'm mildly in favor of title-only for output formats where the title
is a hyperlink: the section number seems like unnecessary verbiage
if you have something you can click on.  However, if there's anyone
out there still printing on dead trees, or using ancient PDF readers
that don't do hyperlinks, loss of the section number would be pretty
catastrophic for following the link.  So this really needs to be
output-format-dependent, which suggests that we could make it adapt
to readers' preferences too: provide some option to decide whether to
include title or section number or both.

			regards, tom lane