Message-ID: <6b0ab4b170d07613277d42411c26cf20f79af578.camel@cybertec.at>
Subject: Re: [Minor] Improve reading in "1.2 Architectural Fundamentals "
 tutorial
From: Laurenz Albe <laurenz.albe@cybertec.at>
To: matematica.a3k@gmail.com, pgsql-docs@lists.postgresql.org
Date: Fri, 25 Sep 2026 10:20:40 +0200
In-Reply-To: 
 <179028157720.1026196.11734567258850512063@wrigleys.postgresql.org>
References: 
 <179028157720.1026196.11734567258850512063@wrigleys.postgresql.org>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
User-Agent: Evolution 3.60.2 (3.60.2-2.fc44) 
MIME-Version: 1.0
Archived-At: 
 <https://www.postgresql.org/message-id/6b0ab4b170d07613277d42411c26cf20f79af578.camel%40cybertec.at>
Precedence: bulk

On Thu, 2026-09-24 at 20:26 +0000, PG Doc comments form wrote:
> Page: https://www.postgresql.org/docs/18/tutorial-arch.html
>=20
> Where it says:
> "As is typical of client/server applications, the client and the server c=
an
> be on different hosts. In that case they communicate over a TCP/IP networ=
k
> connection. You should keep this in mind, because the files that can be
> accessed on a client machine might not be accessible **(or might only be
> accessible using a different file name)** on the database server machine.=
"
>=20
> The distinction "(or might only be accessible using a different file name=
)"
> does not add to the concept and degrades reading. I propose to remove it:
> "As is typical of client/server applications, the client and the server c=
an
> be on different hosts. In that case they communicate over a TCP/IP networ=
k
> connection. You should keep this in mind, because the files that can be
> accessed on a client machine might not be accessible on the database serv=
er
> machine."

I agree with that proposal.
Do you want to prepare a patch?

Yours,
Laurenz Albe