| From: | "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com> |
|---|---|
| To: | Robert Haas <robertmhaas(at)gmail(dot)com> |
| Cc: | Peter Eisentraut <peter(at)eisentraut(dot)org>, Andrew Dunstan <andrew(at)dunslane(dot)net>, pgsql-hackers(at)postgresql(dot)org |
| Subject: | Re: documentation structure |
| Date: | 2024-03-22 16:55:24 |
| Message-ID: | CAKFQuwbDv78v9jq+mKOryN9a3eeK73O1iH6fz9O1jCYf3+Op6g@mail.gmail.com |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-hackers |
On Fri, Mar 22, 2024, 09:32 Robert Haas <robertmhaas(at)gmail(dot)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.
>
>
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Tom Lane | 2024-03-22 17:04:40 | Re: Cannot find a working 64-bit integer type on Illumos |
| Previous Message | Nathan Bossart | 2024-03-22 16:54:48 | Re: Slow GRANT ROLE on PostgreSQL 16 with thousands of ROLEs |