From: Tom Lane <tgl@sss.pgh.pa.us>
To: David G. Johnston <david.g.johnston@gmail.com>
Cc: joshua.a.aguilar@gmail.com
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: Tutorial clarify
Date: Wed, 07 Aug 2024 13:09:19 -0400
Message-ID: <2052673.1723050559@sss.pgh.pa.us> (raw)
In-Reply-To: <CAKFQuwYwN675Z4L9LnrzrnDEj_FSeEj+sLnfPyNn7POBj9QEEQ@mail.gmail.com>
References: <172303331011.915368.173618351605878110@wrigleys.postgresql.org>
<CAKFQuwYwN675Z4L9LnrzrnDEj_FSeEj+sLnfPyNn7POBj9QEEQ@mail.gmail.com>
"David G. Johnston" <david.g.johnston@gmail.com> writes:
> On Wed, Aug 7, 2024 at 7:34 AM PG Doc comments form <noreply@postgresql.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
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: tgl@sss.pgh.pa.us, david.g.johnston@gmail.com, joshua.a.aguilar@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: Tutorial clarify
In-Reply-To: <2052673.1723050559@sss.pgh.pa.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox