From: | Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at> |
---|---|
To: | Liudmila Mantrova <l(dot)mantrova(at)gmail(dot)com>, pgsql-docs(at)lists(dot)postgresql(dot)org, Stephen Frost <sfrost(at)snowman(dot)net>, Sarah Conway Schnurr <xenophenes42(at)gmail(dot)com> |
Subject: | Re: GSoD - a patch for Getting Started tutorial |
Date: | 2019-11-18 09:15:42 |
Message-ID: | 54907b90aa20e603eb4204153c7dd5790ce258a4.camel@cybertec.at |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
On Sun, 2019-11-17 at 00:04 +0300, Liudmila Mantrova wrote:
> Some time ago I was selected to participate in Google season of docs program to update
> the introductory tutorial. Please consider the attached patch for the Getting Started part.
> Keeping the original information, i tried to make it easy to follow, as well as added
> installation steps for binary packages. I'll be glad to hear your feedback.
>
> Many thanks to Alexander Lakhin for responding to my multiple questions and verifying technical correctness.
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?
Quickly skimming over the text, I have two things to comment:
- The RedHat binaries use "trust" authentication by default, not "peer".
- 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.
Yours,
Laurenz Albe
From | Date | Subject | |
---|---|---|---|
Next Message | Andreas Kretschmer | 2019-11-18 14:36:24 | documentation for WITH RECURSIVE |
Previous Message | Yasuhiro Horimoto | 2019-11-18 07:21:05 | Re: I suggest improving install steps for CentOS 8 |