Re: Get rid of "Section.N.N.N" on DOCs - Mailing list pgsql-hackers

From Christophe Pettus
Subject Re: Get rid of "Section.N.N.N" on DOCs
Date
Msg-id 4E0E1ECF-1A2A-46B1-A5D7-37159CC22F2D@thebuild.com
Whole thread
In response to Re: Get rid of "Section.N.N.N" on DOCs  (Marcos Pegoraro <marcos@f10.com.br>)
List pgsql-hackers

> On Jun 24, 2026, at 11:31, Marcos Pegoraro <marcos@f10.com.br> wrote:
> Refer to Time Zones for more information.

Using short text like that for a reference is inevitably going to be ambiguous.  In a web environment where there will
alwaysbe a link, that's arguably not a problem, but if you strip the link for any reason (print, etc.), the reference
becomesat best extremely inconvenient, and worst impossible to follow. 

Hierarchical decimal numbers have been such a constant feature of structured technical documents for so long (decades
upondecades now), that I don't think they are regarded the least bit unusual.  The ability to reference a section
withoutambiguity, IMHO, makes the small formatting issue acceptable (and that formatting issue itself is really a
matterof taste). 


pgsql-hackers by date:

Previous
From: Jelte Fennema-Nio
Date:
Subject: Re: pg_get__*_ddl consolidation
Next
From: Christophe Pettus
Date:
Subject: Re: The PostgreSQL C Dialect