Feedback-ID: i0fe9450f:Fastmail
Date: Mon, 27 Apr 2026 16:18:43 +0900
From: Michael Paquier <michael@paquier.xyz>
To: Peter Smith <smithpb2250@gmail.com>
Cc: PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Subject: Re: DOCS - typos and grammar issues across logical replication docs.
Message-ID: <ae8N09isULnOqvpI@paquier.xyz>
References: 
 <CAHut+PuvY_wYLPJ4DTs7NE9Lu2ty4d-OgZAOJC-NvCM=2wwcQQ@mail.gmail.com>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha512;
	protocol="application/pgp-signature"; boundary="xSVSVKmPJRXpyevn"
Content-Disposition: inline
In-Reply-To: 
 <CAHut+PuvY_wYLPJ4DTs7NE9Lu2ty4d-OgZAOJC-NvCM=2wwcQQ@mail.gmail.com>
Archived-At: 
 <https://www.postgresql.org/message-id/ae8N09isULnOqvpI%40paquier.xyz>
Precedence: bulk


--xSVSVKmPJRXpyevn
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

On Fri, Apr 24, 2026 at 03:32:24PM +1000, Peter Smith wrote:
> I fed the logical replication online documentation into my favourite
> AI tool to help me come up with the following patch that fixes many
> minor issues (e.g., spelling, grammar, inconsistencies, vagueness,
> etc.).

It is a mixed bag of changes.  Some of the suggestions are correct
grammar fixes, some make things somewhat worse, some are irrelevant
(like the s/won't/will not/ or the s/please//).

-  When logical replication of a table typically starts, PostgreSQL takes
-  a snapshot of the table's data on the publisher database and copies it
+  Logical replication of a table typically starts by PostgreSQL taking
+  a snapshot of the table's data on the publisher database and copying it
   to the subscriber.  Once complete, changes on the publisher since the

This new sentence makes less sense here.  And there's nothing bad with
the original.

Some of these mistakes are older than HEAD, and are user-visible, so
backpatched the most relevant ones.

Thanks.
--
Michael

--xSVSVKmPJRXpyevn
Content-Type: application/pgp-signature; name=signature.asc

-----BEGIN PGP SIGNATURE-----

iQIzBAEBCgAdFiEEG72nH6vTowiyblFKnvQgOdbyQH0FAmnvDdMACgkQnvQgOdby
QH1igQ//aOfVLrnp0pZJKML7nE2X34cj8T9MvmoeGlUy8owJ9a4K8U8csc0iqhM2
/Lh1wtTjCtpmeUOVLVyUiQSziBta286DRBhSC1o3LSsLk+XYYafmZqaJ/VlOUoNA
kECT5jZHSlOvXB9sQenhevmwr6W1HzODUWp+PKc4Ah+72bkuBrtq7SkZE8xkCN+N
xKiBDqn0Tqhq7YnHQ9Wk9O7IV55PWYpblX+qwk2qeBxCugNgc/ZCvt1KvKBvMCkR
aYBAkXnj8GP3Tlsg/dszjMJaTfe0ul5++pQ5EOSBERLyYH3zw1cFx/mtuyy3TGDe
R6Arxka3Bn97UyWg4QPNqZqIDGVSlyR+5B7ErtT/jKTsk/vx6nblOSYQVK+oTAMp
1Bas+dvtIIdWS9P8hnh4hxfbT6jlY0DGRSiyGiSLRrYVo5Bx5MZYJeNN+NlcMPyP
y0DTI7Cv6NB9ctSyVAoNiWu93MKoGBSgFY+XrO5WkMSDRwZV+bcUKquijrR+bSoS
EWyQiU5eEbzcCT56HSYMzFluQXfooPeBgQTRrLhyMbcVkFAAa9zABy0DvYihYjnI
dQawKBLG0Uhr/f9xURsljGhQEpy8jGTPOj2N8+LNlALhq/drnW1/lNVL9Fjtjvib
6Wj4SolqGIeRm47jUcRlD7WlPbiRB2dsXWygUCaUSESMbGk9NTs=
=ya6n
-----END PGP SIGNATURE-----

--xSVSVKmPJRXpyevn--