From: Tom Lane <tgl@sss.pgh.pa.us>
To: "David G. Johnston" <david.g.johnston@gmail.com>
cc: joshua.a.aguilar@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: Tutorial clarify
In-reply-to: 
 <CAKFQuwYwN675Z4L9LnrzrnDEj_FSeEj+sLnfPyNn7POBj9QEEQ@mail.gmail.com>
References: <172303331011.915368.173618351605878110@wrigleys.postgresql.org>
 <CAKFQuwYwN675Z4L9LnrzrnDEj_FSeEj+sLnfPyNn7POBj9QEEQ@mail.gmail.com>
Comments: In-reply-to "David G. Johnston" <david.g.johnston@gmail.com>
	message dated "Wed, 07 Aug 2024 08:17:19 -0700"
MIME-Version: 1.0
Content-Type: text/plain; charset="UTF-8"
Content-ID: <2052672.1723050559.1@sss.pgh.pa.us>
Content-Transfer-Encoding: quoted-printable
Date: Wed, 07 Aug 2024 13:09:19 -0400
Message-ID: <2052673.1723050559@sss.pgh.pa.us>
Archived-At: 
 <https://www.postgresql.org/message-id/2052673.1723050559%40sss.pgh.pa.us>
Precedence: bulk

"David G. Johnston" <david.g.johnston@gmail.com> writes:
> On Wed, Aug 7, 2024 at 7:34=E2=80=AFAM PG Doc comments form <noreply@pos=
tgresql.org>
> wrote:
>> New and wanted to follow getting started docs but it seems it was writt=
en
>> for Unix. Would be nice if you built out the getting started docs for m=
ore
>> than Unix. whatever, no one probs reads this anymore. to the void you g=
o!

> 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