From: Jonathan S. Katz <jkatz@postgresql.org>
To: Lætitia Avrot <laetitia.avrot@gmail.com>
To: pgsql-docs@postgresql.org
Subject: Re: Tutorial section of documentation: enhancements needed
Date: Thu, 14 Feb 2019 18:57:14 -0500
Message-ID: <8043cad9-c03f-23e7-ae31-462f135b9f40@postgresql.org> (raw)
In-Reply-To: <CAB_COdjnQtDcg454fZxSM0u--VvJdTuD2heBsXCskQRpAo=abw@mail.gmail.com>
References: <CAB_COdjnQtDcg454fZxSM0u--VvJdTuD2heBsXCskQRpAo=abw@mail.gmail.com>
Hi Laetitia,
On 2/12/19 3:06 AM, Lætitia Avrot wrote:
> To me, there are 2 options:
> - either, we change the "Tutorial" name of that chapter, so millenials
> don't think they will find a step by step doc on how to install,
> configure and connect to Postgres and add a tutorial page (the name can
> be changed) on the postgresql.org <http://postgresql.org; website
I don't know if we need to change the name as much as it needs some
rewriting. Perhaps the whole section is simplified to a "getting
started" that gets people to download, install, and run PostgreSQL in
their desired environment, and then the basic commands to get started
(which I think we do a decent job of that portion?)
In my early days of using PostgreSQL, I remember this being in my
bookmarks for getting started:
https://www.postgresql.org/docs/current/install-short.html
Perhaps we can also boil something down for the modern methods of
installation.
Also I would not necessarily say this is a "millennial" issue, I think
this extends to many new users of PostgreSQL who, in particular, may not
be as used to the command-line. (I also say that as someone who is
technically considered a millennial ;-)
> - either we change the first part "getting started" to add practical
> installation steps (but it might be redundant with the download page of
> postgresql.org <http://postgresql.org;), basic configuration (if needed,
> as how to open connection for your OS user, that kind of things) and how
> to connect with psql on several OS (Windows included).
+1. One thing to consider is that many people also use something like
pgAdmin (I've often heard people thing pgAdmin is PostgreSQL) which also
adds to the how people get started.
> I think we really need to take care of beginners who would like to
> install postgres on their laptop to "give it a try".
A section that was added as part of the website update last year and
subsequently poorly named by me was this:
https://www.postgresql.org/docs/online-resources/
Which contains a list of tutorials and other resources to help get
started with PostgreSQL. We could give this page a better name in the
hope that it helps people with more of the "getting started" pieces
until if/when we change the docs.
Thanks,
Jonathan
Attachments:
signature.asc (application/pgp-signature, 832B) download
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: jkatz@postgresql.org, laetitia.avrot@gmail.com
Subject: Re: Tutorial section of documentation: enhancements needed
In-Reply-To: <8043cad9-c03f-23e7-ae31-462f135b9f40@postgresql.org>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox