Wrong Installation Link

Started by PG Bug reporting form8 months ago3 messagesdocs
Jump to latest
#1PG Bug reporting form
noreply@postgresql.org

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

#2Tom Lane
tgl@sss.pgh.pa.us
In reply to: PG Bug reporting form (#1)
Re: Wrong Installation Link

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

#3Tom Lane
tgl@sss.pgh.pa.us
In reply to: Tom Lane (#2)
Re: Wrong Installation Link

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