agora inbox for pgsql-docs@postgresql.org
help / color / mirror / Atom feedWrong Installation Link
3+ messages / 2 participants
[nested] [flat]
* Wrong Installation Link
@ 2025-08-09 15:27 PG Doc comments form <noreply@postgresql.org>
0 siblings, 1 reply; 3+ messages in thread
From: PG Doc comments form @ 2025-08-09 15:27 UTC (permalink / raw)
To: pgsql-docs@lists.postgresql.org; +Cc: trikooplays@gmail.com
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/17/tutorial-install.html
Description:
In Chapter 1 Section 1 (Installation), the documentation is linking to
Chapter 17 for installing postgresql, however that chapter is titled:
"Installation from source" And the preceding Chapter states:
"PostgreSQL is available in the form of binary packages for most common
operating systems today. When available, this is the recommended way to
install PostgreSQL for users of the system. Building from source (see
Chapter 17) is only recommended for people developing PostgreSQL or
extensions."
^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: Wrong Installation Link
@ 2025-08-09 17:55 Tom Lane <tgl@sss.pgh.pa.us>
parent: PG Doc comments form <noreply@postgresql.org>
0 siblings, 1 reply; 3+ messages in thread
From: Tom Lane @ 2025-08-09 17:55 UTC (permalink / raw)
To: trikooplays@gmail.com; +Cc: pgsql-docs@lists.postgresql.org
PG Doc comments form <noreply@postgresql.org> writes:
> In Chapter 1 Section 1 (Installation), the documentation is linking to
> Chapter 17 for installing postgresql, however that chapter is titled:
> "Installation from source" And the preceding Chapter states:
> "PostgreSQL is available in the form of binary packages for most common
> operating systems today. When available, this is the recommended way to
> install PostgreSQL for users of the system. Building from source (see
> Chapter 17) is only recommended for people developing PostgreSQL or
> extensions."
You're right, we should re-point that link at chapter 16.
Thumbing through the other references to the "installation" chapter,
I think we should also change the first one in runtime.sgml,
which is in the material about upgrading. The other ones seem
fine as-is because they are talking about choices you might make
when building from source.
regards, tom lane
^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: Wrong Installation Link
@ 2025-08-09 19:18 Tom Lane <tgl@sss.pgh.pa.us>
parent: Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 0 replies; 3+ messages in thread
From: Tom Lane @ 2025-08-09 19:18 UTC (permalink / raw)
To: trikooplays@gmail.com; +Cc: pgsql-docs@lists.postgresql.org
I wrote:
> PG Doc comments form <noreply@postgresql.org> writes:
>> In Chapter 1 Section 1 (Installation), the documentation is linking to
>> Chapter 17 for installing postgresql, however that chapter is titled:
>> "Installation from source"
> You're right, we should re-point that link at chapter 16.
Actually ... a one-liner fix doesn't really seem appropriate here,
because almost all of "tutorial-install" is essentially talking
about installation from source. Certainly the remark about
not needing superuser wouldn't apply to most scenarios where
you're installing from distro-provided packages.
So I'm feeling like maybe we need a full rewrite of these
few paragraphs, not just a link update.
regards, tom lane
^ permalink raw reply [nested|flat] 3+ messages in thread
end of thread, other threads:[~2025-08-09 19:18 UTC | newest]
Thread overview: 3+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2025-08-09 15:27 Wrong Installation Link PG Doc comments form <noreply@postgresql.org>
2025-08-09 17:55 ` Tom Lane <tgl@sss.pgh.pa.us>
2025-08-09 19:18 ` Tom Lane <tgl@sss.pgh.pa.us>
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox