Re: Wrong Installation Link

2025-08-09 Thread Tom Lane
PG Doc comments form  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




Re: Wrong Installation Link

2025-08-09 Thread Tom Lane
I wrote:
> PG Doc comments form  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




Wrong Installation Link

2025-08-09 Thread PG Doc comments form
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."