Re: [Minor] Improve reading in "1.2 Architectural Fundamentals " tutorial

From: Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>
To: matematica(dot)a3k(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: [Minor] Improve reading in "1.2 Architectural Fundamentals " tutorial
Date: 2026-09-25 08:20:40
Message-ID: 6b0ab4b170d07613277d42411c26cf20f79af578.camel@cybertec.at
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: 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

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2026-09-25 09:32:36 log_line_prefix and JSON log format
Previous Message Laurenz Albe 2026-09-25 08:18:47 Re: [Minor] Improve reading in "2. A Brief History of PostgreSQL"