Message-ID: <11c77608b0d5fa9164920430d2ffc7c06e772de4.camel@cybertec.at>
Subject: Re: Incorrect grammar
From: Laurenz Albe <laurenz.albe@cybertec.at>
To: william.r.pursell@gmail.com, pgsql-docs@lists.postgresql.org
Date: Sun, 19 Jul 2026 21:49:21 +0200
In-Reply-To: 
 <178433358027.824456.16086075130836422432@wrigleys.postgresql.org>
References: 
	<178433358027.824456.16086075130836422432@wrigleys.postgresql.org>
Content-Type: multipart/mixed; boundary="=-De7ycZarjYr5iYKbZDEw"
User-Agent: Evolution 3.58.3 (3.58.3-1.fc43) 
MIME-Version: 1.0
Archived-At: 
 <https://www.postgresql.org/message-id/11c77608b0d5fa9164920430d2ffc7c06e772de4.camel%40cybertec.at>
Precedence: bulk

--=-De7ycZarjYr5iYKbZDEw
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Sat, 2026-07-18 at 00:13 +0000, PG Doc comments form wrote:
> The collection of words "The user's client (frontend) application that wa=
nts
> to perform database operations." is not a complete sentence.  (This is fr=
om
> https://www.postgresql.org/docs/current/tutorial-arch.html). Perhaps you
> want to say "A client process is an application that wants to perform
> database operations" or similar.

It makes sense if you look at the sentence before the enumeration:

  A PostgreSQL session consists of the following cooperating processes (pro=
grams):

  - A server process, which [...]. The database server program is called po=
stgres.

  - The user's client (frontend) application that wants to perform database=
 operations.

Perhaps the source of the problem is that the fragment starts with a capita=
lized
word and ends with a period.  But since there are sentences following the f=
ragment,
I am not sure how the correct punctuation would be.

Perhaps the fragments could be turned into whole sentences, like

  Second, there is the user's client (frontend) application that wants to p=
erform
  database operations.

Would the attached patch improve the situation for you?

Yours,
Laurenz Albe

--=-De7ycZarjYr5iYKbZDEw
Content-Disposition: attachment;
 filename="v1-0001-Use-whole-sentences-in-the-tutorial.patch"
Content-Type: text/x-patch;
 name="v1-0001-Use-whole-sentences-in-the-tutorial.patch";
	charset="UTF-8"
Content-Transfer-Encoding: base64

RnJvbSBmMDU1ODY0YWE4MGJhNmJhNzhkZjg1OWFkN2E3MjA4YjA5MWEzZTZhIE1vbiBTZXAgMTcg
MDA6MDA6MDAgMjAwMQpGcm9tOiBMYXVyZW56IEFsYmUgPGxhdXJlbnouYWxiZUBjeWJlcnRlYy5h
dD4KRGF0ZTogU3VuLCAxOSBKdWwgMjAyNiAyMTo0NzowNyArMDIwMApTdWJqZWN0OiBbUEFUQ0gg
djFdIFVzZSB3aG9sZSBzZW50ZW5jZXMgaW4gdGhlIHR1dG9yaWFsCgpJbiBhbiBlbnVtZXJhdGlv
biBpbiB0aGUgdHV0b3JpYWwsIHRoZSBpbmRpdmlkdWFsIGl0ZW1zIHN0YXJ0IHdpdGgKc2VudGVu
Y2UgZnJhZ21lbnRzIHRoYXQgZW5kIHdpdGggYSBwZXJpb2QuICBUaGlzIGNvbmZ1c2VkIGF0IGxl
YXN0IG9uZQpyZWFkZXIsIHNvIGxldCdzIHVzZSB3aG9sZSBzZW50ZW5jZXMgaW4gdGhpcyBwbGFj
ZS4KClJlcG9ydDogV2lsbGlhbSBSLiBQdXJzZWxsIDx3aWxsaWFtLnIucHVyc2VsbEBnbWFpbC5j
b20+CkF1dGhvcjogTGF1cmVueiBBbGJlIDxsYXVyZW56LmFsYmVAY3liZXJ0ZWMuYXQ+CkRpc2N1
c3Npb246IGh0dHBzOi8vcG9zdGdyLmVzL20vMTc4NDMzMzU4MDI3LjgyNDQ1Ni4xNjA4NjA3NTEz
MDgzNjQyMjQzMiU0MHdyaWdsZXlzLnBvc3RncmVzcWwub3JnCi0tLQogZG9jL3NyYy9zZ21sL3N0
YXJ0LnNnbWwgfCA0ICsrLS0KIDEgZmlsZSBjaGFuZ2VkLCAyIGluc2VydGlvbnMoKyksIDIgZGVs
ZXRpb25zKC0pCgpkaWZmIC0tZ2l0IGEvZG9jL3NyYy9zZ21sL3N0YXJ0LnNnbWwgYi9kb2Mvc3Jj
L3NnbWwvc3RhcnQuc2dtbAppbmRleCAwMjYzYTcwMDU5MS4uMjM5MzVhMDY0OWUgMTAwNjQ0Ci0t
LSBhL2RvYy9zcmMvc2dtbC9zdGFydC5zZ21sCisrKyBiL2RvYy9zcmMvc2dtbC9zdGFydC5zZ21s
CkBAIC03Miw3ICs3Miw3IEBACiAgICAgPGl0ZW1pemVkbGlzdD4KICAgICAgPGxpc3RpdGVtPgog
ICAgICAgPHBhcmE+Ci0gICAgICAgQSBzZXJ2ZXIgcHJvY2Vzcywgd2hpY2ggbWFuYWdlcyB0aGUg
ZGF0YWJhc2UgZmlsZXMsIGFjY2VwdHMKKyAgICAgICBGaXJzdCwgdGhlcmUgaXMgYSBzZXJ2ZXIg
cHJvY2Vzcywgd2hpY2ggbWFuYWdlcyB0aGUgZGF0YWJhc2UgZmlsZXMsIGFjY2VwdHMKICAgICAg
ICBjb25uZWN0aW9ucyB0byB0aGUgZGF0YWJhc2UgZnJvbSBjbGllbnQgYXBwbGljYXRpb25zLCBh
bmQKICAgICAgICBwZXJmb3JtcyBkYXRhYmFzZSBhY3Rpb25zIG9uIGJlaGFsZiBvZiB0aGUgY2xp
ZW50cy4gIFRoZQogICAgICAgIGRhdGFiYXNlIHNlcnZlciBwcm9ncmFtIGlzIGNhbGxlZApAQCAt
ODMsNyArODMsNyBAQAogCiAgICAgIDxsaXN0aXRlbT4KICAgICAgIDxwYXJhPgotICAgICAgIFRo
ZSB1c2VyJ3MgY2xpZW50IChmcm9udGVuZCkgYXBwbGljYXRpb24gdGhhdCB3YW50cyB0byBwZXJm
b3JtCisgICAgICAgU2Vjb25kLCB0aGVyZSBpcyB0aGUgdXNlcidzIGNsaWVudCAoZnJvbnRlbmQp
IGFwcGxpY2F0aW9uIHRoYXQgd2FudHMgdG8gcGVyZm9ybQogICAgICAgIGRhdGFiYXNlIG9wZXJh
dGlvbnMuICBDbGllbnQgYXBwbGljYXRpb25zIGNhbiBiZSB2ZXJ5IGRpdmVyc2UKICAgICAgICBp
biBuYXR1cmU6ICBhIGNsaWVudCBjb3VsZCBiZSBhIHRleHQtb3JpZW50ZWQgdG9vbCwgYSBncmFw
aGljYWwKICAgICAgICBhcHBsaWNhdGlvbiwgYSB3ZWIgc2VydmVyIHRoYXQgYWNjZXNzZXMgdGhl
IGRhdGFiYXNlIHRvCi0tIAoyLjU1LjAKCg==


--=-De7ycZarjYr5iYKbZDEw--