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
From f055864aa80ba6ba78df859ad7a7208b091a3e6a Mon Sep 17 00:00:00 2001 From: Laurenz Albe <[email protected]> Date: Sun, 19 Jul 2026 21:47:07 +0200 Subject: [PATCH v1] Use whole sentences in the tutorial In an enumeration in the tutorial, the individual items start with sentence fragments that end with a period. This confused at least one reader, so let's use whole sentences in this place. Report: William R. Pursell <[email protected]> Author: Laurenz Albe <[email protected]> Discussion: https://postgr.es/m/178433358027.824456.16086075130836422432%40wrigleys.postgresql.org --- doc/src/sgml/start.sgml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/src/sgml/start.sgml b/doc/src/sgml/start.sgml index 0263a700591..23935a0649e 100644 --- a/doc/src/sgml/start.sgml +++ b/doc/src/sgml/start.sgml @@ -72,7 +72,7 @@ <itemizedlist> <listitem> <para> - A server process, which manages the database files, accepts + First, there is a server process, which manages the database files, accepts connections to the database from client applications, and performs database actions on behalf of the clients. The database server program is called @@ -83,7 +83,7 @@ <listitem> <para> - The user's client (frontend) application that wants to perform + Second, there is the user's client (frontend) application that wants to perform database operations. Client applications can be very diverse in nature: a client could be a text-oriented tool, a graphical application, a web server that accesses the database to -- 2.55.0
