Re: PG DOCS - logical replication filtering - Mailing list pgsql-hackers

Not changed. Because in fact, I copied most of this sentence

(including the uppercase, "operations", "and/or") from existing

documentation [1]

e.g. see "The tables added to a publication that publishes UPDATE

and/or DELETE operations must ..."

[1] https://www.postgresql.org/docs/current/sql-createpublication.html

Yeah, I know the information is the same in the summary and in the

text. Personally, I find big slabs of technical text difficult to

digest, so I'd have to spend 5 minutes of careful reading and drawing

the exact same summary on a piece of paper anyway just to visualize

what the text says. The summary makes it easy to understand at a

glance. But I have modified the summary in [v9] to remove the "case"

and to add other column headings as suggested.

Not changed. The readers of this docs page are all users who will be

familiar with the filter expressions, so I felt the "OR'ed together"

part will be perfectly clear to the intended audience.

But I did not understand your point about “If, for some reason,

someone decided to change it, this section will contain obsolete

information”, because IIUC that will be equally true for both the

explanation and the output, so I did not understand why you say "psql

output is fine, the explanation is not". It is the business of this

documentation to help the user to know how and where they can find the

row filter information they may need to know.

Not changed. The publisher and subscriber programlistings are always

separated. If you are looking at the rendered HTML I think it is quite

clear that one is at the publisher and one is at the subscriber. OTOH,

if we omitted creating the tables on the subscriber then I think that

really would cause some confusion.