Re: User documentation vs Official Docs - Mailing list pgsql-general

From David G. Johnston
Subject Re: User documentation vs Official Docs
Date
Msg-id CAKFQuwbsrq833N8ZXK0d0-R-Ft99PRrVtvigdnCzUpz4vrjCeQ@mail.gmail.com
Whole thread Raw
In response to User documentation vs Official Docs  ("Joshua D. Drake" <jd@commandprompt.com>)
Responses Re: User documentation vs Official Docs  ("Joshua D. Drake" <jd@commandprompt.com>)
List pgsql-general
On Mon, Jul 16, 2018 at 1:32 PM, Joshua D. Drake <jd@commandprompt.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.

pgsql-general by date:

Previous
From: Tim Cross
Date:
Subject: Re: User documentation vs Official Docs
Next
From: Adrien Nayrat
Date:
Subject: Re: Query to monitor index bloat