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

From: PG Doc comments form <noreply(at)postgresql(dot)org>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Cc: matematica(dot)a3k(at)gmail(dot)com
Subject: [Minor] Improve reading in "1.2 Architectural Fundamentals " tutorial
Date: 2026-09-24 20:26:17
Message-ID: 179028157720.1026196.11734567258850512063@wrigleys.postgresql.org
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/18/tutorial-arch.html
Description:

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

Thanks!

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2026-09-24 21:05:50 [Minor] Improve reading in "2. A Brief History of PostgreSQL"
Previous Message PG Doc comments form 2026-09-24 19:58:22 [Minor] Duplicated word in "Creating a Database" tutorial