| From: | Christophe Pettus <xof(at)thebuild(dot)com> |
|---|---|
| To: | Marcos Pegoraro <marcos(at)f10(dot)com(dot)br> |
| Cc: | Peter Eisentraut <peter(at)eisentraut(dot)org>, Douglas Domingues da Silveira <douglas(at)f10(dot)com(dot)br>, Robert Treat <rob(at)xzilla(dot)net>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org> |
| Subject: | Re: Get rid of "Section.N.N.N" on DOCs |
| Date: | 2026-06-24 20:07:12 |
| Message-ID: | 4E0E1ECF-1A2A-46B1-A5D7-37159CC22F2D@thebuild.com |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-hackers |
> On Jun 24, 2026, at 11:31, Marcos Pegoraro <marcos(at)f10(dot)com(dot)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 always be a link, that's arguably not a problem, but if you strip the link for any reason (print, etc.), the reference becomes at 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 upon decades now), that I don't think they are regarded the least bit unusual. The ability to reference a section without ambiguity, IMHO, makes the small formatting issue acceptable (and that formatting issue itself is really a matter of taste).
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Christophe Pettus | 2026-06-24 20:09:03 | Re: The PostgreSQL C Dialect |
| Previous Message | Bharath Rupireddy | 2026-06-24 20:06:55 | Re: [PATCH] Fix sequence value may rollback after CREATE DATABASE TEMPLATE with WAL_LOG strategy |