Re: GSoD - a patch for Getting Started tutorial

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

In response to

Responses

Browse pgsql-docs by date

  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