From: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
---|---|
To: | "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com> |
Cc: | joshua(dot)a(dot)aguilar(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org |
Subject: | Re: Tutorial clarify |
Date: | 2024-08-07 17:09:19 |
Message-ID: | 2052673.1723050559@sss.pgh.pa.us |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
"David G. Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com> writes:
> On Wed, Aug 7, 2024 at 7:34 AM PG Doc comments form <noreply(at)postgresql(dot)org>
> wrote:
>> New and wanted to follow getting started docs but it seems it was written
>> for Unix. Would be nice if you built out the getting started docs for more
>> than Unix. whatever, no one probs reads this anymore. to the void you go!
> Maybe 1% of the content is OS-specific and those pieces seem easily
> translatable to Windows as it's basically just writing a different path.
Yeah, there's not that much that's environment-specific, but sadly
just about all of it is stuff a newbie has to deal with before writing
their first SQL command. I'm not sure how we can make that better in
an environment-agnostic way though. We are certainly not going to
provide N different sets of instructions trying to cover all the
popular packagings of Postgres: it would be a mess and would likely be
constantly out-of-date. As you say, that's really the responsibility
of the packagers.
Perhaps we should make "1.1. Installation" refer more explicitly to
packager-supplied documentation? And I wonder how many people reading
that really have a "site administrator" who is not them. Even for
people running Unix/Linux, that text seems like it's making archaic
assumptions.
regards, tom lane
From | Date | Subject | |
---|---|---|---|
Next Message | PG Doc comments form | 2024-08-08 08:42:33 | Managing SSL Connections |
Previous Message | David G. Johnston | 2024-08-07 15:17:19 | Re: Tutorial clarify |