Re: Incorrect grammar

From: Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>
To: william(dot)r(dot)pursell(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Incorrect grammar
Date: 2026-07-19 19:49:21
Message-ID: 11c77608b0d5fa9164920430d2ffc7c06e772de4.camel@cybertec.at
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

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 wants
> to perform database operations." is not a complete sentence. (This is from
> 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 (programs):

- A server process, which [...]. The database server program is called postgres.

- 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 capitalized
word and ends with a period. But since there are sentences following the fragment,
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 perform
database operations.

Would the attached patch improve the situation for you?

Yours,
Laurenz Albe

Attachment Content-Type Size
v1-0001-Use-whole-sentences-in-the-tutorial.patch text/x-patch 1.6 KB

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Daniel Gustafsson 2026-07-19 19:56:32 Re: [PATCH] doc: outline all planner nodes
Previous Message TheOtherBrian1 2026-07-19 00:26:30 Re: [PATCH] doc: outline all planner nodes