Re: documentation structure - Mailing list pgsql-hackers

From David G. Johnston
Subject Re: documentation structure
Date
Msg-id CAKFQuwbDv78v9jq+mKOryN9a3eeK73O1iH6fz9O1jCYf3+Op6g@mail.gmail.com
Whole thread Raw
In response to Re: documentation structure  (Robert Haas <robertmhaas@gmail.com>)
List pgsql-hackers
On Fri, Mar 22, 2024, 09:32 Robert Haas <robertmhaas@gmail.com> wrote:


I notice that you say that the "Installation" section should "cover
the architectural overview and point people to where they can find the
stuff they need to install PostgreSQL in the various ways available to
them" so maybe you're not imagining a four-sentence chapter, either.

Fair point but I posit that new users are looking for a chapter named Installation in the documentation.  At least the ones willing to read documentation.  Having two of them isn't needed but having zero doesn't make sense either.

The current proposal does that so I'm ok as-is but it can be further improved by moving source install talk elsewhere and having the installation chapter redirect the reader there for details.  I'm not concerned with how long or short the resultant installation chapter is.

David J.

pgsql-hackers by date:

Previous
From: Nathan Bossart
Date:
Subject: Re: Slow GRANT ROLE on PostgreSQL 16 with thousands of ROLEs
Next
From: Tom Lane
Date:
Subject: Re: Cannot find a working 64-bit integer type on Illumos