Message-ID: <ec20719e575c5cbe69cccf1616e80d9b47d43c18.camel@cybertec.at>
Subject: Re: GSoD - a patch for Getting Started tutorial
From: Laurenz Albe <laurenz.albe@cybertec.at>
To: Liudmila Mantrova <l.mantrova@gmail.com>
Cc: pgsql-docs@lists.postgresql.org, Stephen Frost <sfrost@snowman.net>,
	Sarah Conway Schnurr <xenophenes42@gmail.com>
Date: Tue, 19 Nov 2019 09:00:36 +0100
In-Reply-To: 
 <CAEkD-mD-A1p=xZ7URBM4L5KUap63MQMYh9x1QTTtyFHX+5QcQQ@mail.gmail.com>
References: 
	<CAEkD-mAxCk_mX_RwjyxBLHEjt_T5-mS-c6ryfh3nBjdbyYMC0g@mail.gmail.com>
	 <54907b90aa20e603eb4204153c7dd5790ce258a4.camel@cybertec.at>
	 <CAEkD-mD-A1p=xZ7URBM4L5KUap63MQMYh9x1QTTtyFHX+5QcQQ@mail.gmail.com>
Content-Type: text/plain; charset="UTF-8"
User-Agent: Evolution 3.32.4 (3.32.4-1.fc30) 
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Precedence: bulk

On Mon, 2019-11-18 at 23:35 +0300, Liudmila Mantrova wrote:
> > I am a bit uncomfortable about having details about the workings of
> > binary packages for specific operating systems in the core documentation.
> > Maybe I'm too sensitive there, but what about having these parts in the Wiki
> > and linking there from the tutorial?
> 
> I also had my doubts about it, but since we are only talking about PGDG packages that
> the community supports, it's probably OK to have it in docs? Besides, I believe we
> should be consistent here - if we are hand-holding the user through the source install,
> we should have a description for binary install as well (which is even more useful for novices).
> I also think it makes the tutorial self-contained, which seems to address one of the
> concerns raised in the presentation you are referring to.

Perhaps you are right, but I wonder if following a link into the Wiki
would be a great hurdle for the novice.
I personally thought that a lot of the complaints in the presentation
were ridiculous, so we need not follow its recommendations slavishly. 

> > Quickly skimming over the text, I have two things to comment:
> > - The RedHat binaries use "trust" authentication by default, not "peer".
>
> Do you mean PGDG binaries or any other binaries? For a PGDG install on e.g. RHEL 8,
> peer seems to be the default.
> But now that you mentioned it, I realized that trust is the default for
> source installs and it might be worth adding, too. I'll try to tweak this part again.

The binaries for Fedora Linux use "trust".

I think that the source installation is covered well enough.
 
> > - I couldn't see anything about Windows.
> >   I think that particularly on Windows people would need a tutorial most,
> >   not because Windows people are more clueless, but because things work
> >   differently there.  Many Windows users don't know how to start a shell.
>  
> I think we can extend it with Windows specifics if there are no other major concerns.
> (But it'll probably take some time for me to try it and figure out the differences.
> Although I know how to start a shell, I'm sure I'll face other problems. :))

I understand your reluctance.
But if we want to cater for clueless beginners, we cannot omit Windows.

Yours,
Laurenz Albe
-- 
Cybertec | https://www.cybertec-postgresql.com