Re: User documentation vs Official Docs

From: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
To: "Joshua D(dot) Drake" <jd(at)commandprompt(dot)com>
Cc: "Psql_General (E-mail)" <pgsql-general(at)postgresql(dot)org>
Subject: Re: User documentation vs Official Docs
Date: 2018-07-16 22:14:24
Message-ID: CAKFQuwbsrq833N8ZXK0d0-R-Ft99PRrVtvigdnCzUpz4vrjCeQ@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-general

On Mon, Jul 16, 2018 at 1:32 PM, Joshua D. Drake <jd(at)commandprompt(dot)com>
wrote:

> -general.
>
> Over the last year as I have visited many meetups and interacted with
> people at conferences etc... There are three prevailing issues that
> continue to come up in contributing to the community. This email is about
> one of them. Where is the "user" documentation? The official documentation
> is awesome, if you know what you are doing. It is not particularly useful
> for HOWTO style docs. There is some user documentation in the wiki but
> let's be honest, writing a blog/article/howto in a wiki is a pain in the
> butt.
>
> What does the community think about a community run, community organized,
> sub project for USER documentation? This type of documentation would be
> things like, "10 steps to configure replication", "Dumb simple Postgres
> backups", "5 things to NEVER do with Postgres". I imagine we would sort it
> by version (9.6/10.0 etc...) as well as break it down via type
> (Administration, Tuning, Gotchas) etc...
>
> What do we think?
>

​Politely tell them to buy some of the many well written books that are
available on these very topics...

David J.

In response to

Responses

Browse pgsql-general by date

  From Date Subject
Next Message Adrien Nayrat 2018-07-16 22:16:13 Re: Query to monitor index bloat
Previous Message Tim Cross 2018-07-16 22:07:24 Re: User documentation vs Official Docs