From: Alvaro Herrera <alvherre@alvh.no-ip.org>
To: splarv@ya.ru
To: pgsql-docs@lists.postgresql.org
Subject: Re: 31.7.1. Initial Snapshot
Date: Wed, 11 Oct 2023 18:39:43 +0200
Message-ID: <202310111639.urgm5z2ri2jp@alvherre.pgsql> (raw)
In-Reply-To: <169704184201.656.8380020202123281494@wrigleys.postgresql.org>
On 2023-Oct-11, PG Doc comments form wrote:
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/16/logical-replication-architecture.html
> Description:
>
> There are dublicated section named "31.7.1. Initial Snapshot" on
> https://www.postgresql.org/docs/16/logical-replication-architecture.html
Yeah, that looks a bit ugly ... but actually the first line you see with
that text is the table-of-contents for the page. Since there's a single
section in that chapter, the TOC looks like a section title. You can
probably find several pages in the docs where this happens.
Maybe a fix for this would be to style chapter TOCs in some way that
makes it clear that they are TOCs -- for example, add a (subtly) visible
bounding box, or something. Or maybe if a chapter has a single section,
just do not print the TOC at all. I have no idea how to implement such
a fix, or whether it'd be really acceptable after all.
--
Álvaro Herrera PostgreSQL Developer — https://www.EnterpriseDB.com/
"After a quick R of TFM, all I can say is HOLY CR** THAT IS COOL! PostgreSQL was
amazing when I first started using it at 7.2, and I'm continually astounded by
learning new features and techniques made available by the continuing work of
the development team."
Berend Tober, http://archives.postgresql.org/pgsql-hackers/2007-08/msg01009.php
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: pgsql-docs@postgresql.org
Cc: alvherre@alvh.no-ip.org, splarv@ya.ru, pgsql-docs@lists.postgresql.org
Subject: Re: 31.7.1. Initial Snapshot
In-Reply-To: <202310111639.urgm5z2ri2jp@alvherre.pgsql>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox