pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feed[Minor] Improve reading in "1.2 Architectural Fundamentals " tutorial
2+ messages / 2 participants
[nested] [flat]
* [Minor] Improve reading in "1.2 Architectural Fundamentals " tutorial
@ 2026-09-24 20:26 PG Doc comments form <noreply@postgresql.org>
2026-09-25 08:20 ` Re: [Minor] Improve reading in "1.2 Architectural Fundamentals " tutorial Laurenz Albe <laurenz.albe@cybertec.at>
0 siblings, 1 reply; 2+ messages in thread
From: PG Doc comments form @ 2026-09-24 20:26 UTC (permalink / raw)
To: pgsql-docs@lists.postgresql.org; +Cc: matematica.a3k@gmail.com
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!
^ permalink raw reply [nested|flat] 2+ messages in thread
* Re: [Minor] Improve reading in "1.2 Architectural Fundamentals " tutorial
2026-09-24 20:26 [Minor] Improve reading in "1.2 Architectural Fundamentals " tutorial PG Doc comments form <noreply@postgresql.org>
@ 2026-09-25 08:20 ` Laurenz Albe <laurenz.albe@cybertec.at>
0 siblings, 0 replies; 2+ messages in thread
From: Laurenz Albe @ 2026-09-25 08:20 UTC (permalink / raw)
To: matematica.a3k@gmail.com; pgsql-docs@lists.postgresql.org
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
^ permalink raw reply [nested|flat] 2+ messages in thread
end of thread, other threads:[~2026-09-25 08:20 UTC | newest]
Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2026-09-24 20:26 [Minor] Improve reading in "1.2 Architectural Fundamentals " tutorial PG Doc comments form <noreply@postgresql.org>
2026-09-25 08:20 ` Laurenz Albe <laurenz.albe@cybertec.at>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox