MIME-Version: 1.0
References: 
 <CAEkD-mAxCk_mX_RwjyxBLHEjt_T5-mS-c6ryfh3nBjdbyYMC0g@mail.gmail.com>
 <54907b90aa20e603eb4204153c7dd5790ce258a4.camel@cybertec.at>
In-Reply-To: <54907b90aa20e603eb4204153c7dd5790ce258a4.camel@cybertec.at>
From: Liudmila Mantrova <l.mantrova@gmail.com>
Date: Mon, 18 Nov 2019 23:35:13 +0300
Message-ID: 
 <CAEkD-mD-A1p=xZ7URBM4L5KUap63MQMYh9x1QTTtyFHX+5QcQQ@mail.gmail.com>
Subject: Re: GSoD - a patch for Getting Started tutorial
To: Laurenz Albe <laurenz.albe@cybertec.at>
Cc: pgsql-docs@lists.postgresql.org, Stephen Frost <sfrost@snowman.net>,
	Sarah Conway Schnurr <xenophenes42@gmail.com>
Content-Type: multipart/alternative; boundary="0000000000002d902c0597a4e38b"
Precedence: bulk

--0000000000002d902c0597a4e38b
Content-Type: text/plain; charset="UTF-8"

Thank you, Laurenz!

On Mon, Nov 18, 2019 at 12:15 PM Laurenz Albe <laurenz.albe@cybertec.at>
wrote:

> On Sun, 2019-11-17 at 00:04 +0300, Liudmila Mantrova wrote:
>
> This is a good thing; I have seen people complain about the tutorial
> (
> https://www.postgresql.eu/events/pgconfeu2019/schedule/session/2735-whats-wrong-with-postgres/
> ).
> I really hope that your work doesn't go to waste
>

> 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.

>
> 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.


> - 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. :))

-- 
Best regards,
Liudmila Mantrova

Technical writer at Postgres Professional: http://www.postgrespro.com

--0000000000002d902c0597a4e38b
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div>Thank you, Laurenz!<br></div><br><div class=3D"gmail_=
quote"><div dir=3D"ltr" class=3D"gmail_attr">On Mon, Nov 18, 2019 at 12:15 =
PM Laurenz Albe &lt;<a href=3D"mailto:laurenz.albe@cybertec.at" target=3D"_=
blank">laurenz.albe@cybertec.at</a>&gt; wrote:<br></div><blockquote class=
=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rg=
b(204,204,204);padding-left:1ex">On Sun, 2019-11-17 at 00:04 +0300, Liudmil=
a Mantrova wrote:<br>
<br>
This is a good thing; I have seen people complain about the tutorial<br>
(<a href=3D"https://www.postgresql.eu/events/pgconfeu2019/schedule/session/=
2735-whats-wrong-with-postgres/" rel=3D"noreferrer" target=3D"_blank">https=
://www.postgresql.eu/events/pgconfeu2019/schedule/session/2735-whats-wrong-=
with-postgres/</a>).<br>
I really hope that your work doesn&#39;t go to waste=C2=A0 <br></blockquote=
><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border=
-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
I am a bit uncomfortable about having details about the workings of<br>
binary packages for specific operating systems in the core documentation.<b=
r>
Maybe I&#39;m too sensitive there, but what about having these parts in the=
 Wiki<br>
and linking there from the tutorial?<br></blockquote><div>=C2=A0</div><div>=
I also had my doubts about it, but since we are only talking about PGDG pac=
kages that the community supports, it&#39;s probably OK to have it in docs?=
 Besides, I believe we should be consistent here - if we are hand-holding t=
he 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 m=
akes the tutorial self-contained, which seems to address one of the concern=
s raised in the presentation you are referring to.</div><blockquote class=
=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rg=
b(204,204,204);padding-left:1ex">
<br>
Quickly skimming over the text, I have two things to comment:<br>
- The RedHat binaries use &quot;trust&quot; authentication by default, not =
&quot;peer&quot;.<br></blockquote><div>=C2=A0</div><div>Do you mean PGDG bi=
naries or any other binaries? For a PGDG install on e.g. RHEL 8, peer seems=
 to be the default.<br>But now that you mentioned it, I realized that trust=
 is the default for source installs and it might be worth adding, too. I=
9;ll try to tweak this part again.<br></div><div>=C2=A0</div><blockquote cl=
ass=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid=
 rgb(204,204,204);padding-left:1ex">
- I couldn&#39;t see anything about Windows.<br>
=C2=A0 I think that particularly on Windows people would need a tutorial mo=
st,<br>
=C2=A0 not because Windows people are more clueless, but because things wor=
k<br>
=C2=A0 differently there.=C2=A0 Many Windows users don&#39;t know how to st=
art a shell.<br></blockquote><div>=C2=A0</div><div>I think we can extend it=
 with Windows specifics if there are no other major concerns. (But it&#39;l=
l probably take some time for me to try it and figure out the differences. =
Although I know how to start a shell, I&#39;m sure I&#39;ll face other prob=
lems. :))<br></div></div><br>-- <br><div dir=3D"ltr"><div dir=3D"ltr">Best =
regards,<div>Liudmila Mantrova=C2=A0</div><div><br></div><div>Technical wri=
ter at Postgres Professional: <a href=3D"http://www.postgrespro.com" target=
=3D"_blank">http://www.postgrespro.com</a></div></div></div></div>

--0000000000002d902c0597a4e38b--