| 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 |
| 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 |