Re: [Minor] Improve reading in "1.2 Architectural Fundamentals " tutorial - Mailing list pgsql-docs

From Laurenz Albe
Subject Re: [Minor] Improve reading in "1.2 Architectural Fundamentals " tutorial
Date
Msg-id 6b0ab4b170d07613277d42411c26cf20f79af578.camel@cybertec.at
Whole thread
In response to [Minor] Improve reading in "1.2 Architectural Fundamentals " tutorial  (PG Doc comments form <noreply@postgresql.org>)
List pgsql-docs
On Thu, 2026-09-24 at 20:26 +0000, PG Doc comments form wrote:
> Page: https://www.postgresql.org/docs/18/tutorial-arch.html
>
> Where it says:
> "As is typical of client/server applications, the client and the server can
> be on different hosts. In that case they communicate over a TCP/IP network
> 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."
>
> 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 can
> be on different hosts. In that case they communicate over a TCP/IP network
> 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 server
> machine."

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

Yours,
Laurenz Albe



pgsql-docs by date:

Previous
From: Laurenz Albe
Date:
Subject: Re: [Minor] Improve reading in "2. A Brief History of PostgreSQL"
Next
From: PG Doc comments form
Date:
Subject: log_line_prefix and JSON log format