Re: pgsql: Doc: Explain about Column List feature.
Alvaro Herrera <alvherre@alvh.no-ip.org>
From: Alvaro Herrera <alvherre@alvh.no-ip.org>
To: Peter Smith <smithpb2250@gmail.com>
Cc: Amit Kapila <akapila@postgresql.org>, pgsql-hackers@lists.postgresql.org
Date: 2022-12-21T07:59:08Z
Lists: pgsql-hackers
On 2022-Dec-21, Peter Smith wrote:
> By "searching" I also meant just scanning visually, although I was
> thinking more about scanning the PDF.
>
> Right now, the intention of any text box is obvious at a glance
> because of those titles like "Caution", "Tip", "Note", "Warning".
> Sure, the HTML rendering also uses colours to convey the purpose, but
> in the PDF version [1] everything is black-and-white so apart from the
> title all boxes look the same. That's why I felt using non-standard
> box titles might be throwing away some of the meaning - e.g. the
> reader of the PDF won't know anymore at a glance are they looking at a
> warning or a tip.
Oh, I see. It's been so long that I haven't looked at the PDFs, that I
failed to realize that they don't use color. I agree that would be a
problem. Maybe we can change the title to have the word:
<title>Warning: Combining Column Lists from Multiple Publications</title>
--
Álvaro Herrera PostgreSQL Developer — https://www.EnterpriseDB.com/
Commits
-
Rework <warning> box about column list combining in logical replication
- d8209d09170f 15.2 landed
- c6f21b2ac215 16.0 landed
-
Copy-edit docs for logical replication column lists
- bfa58a679a57 15.0 landed
- 3a06a79cd137 16.0 landed
-
Doc: Explain about Column List feature.
- f98d07424523 16.0 cited