User documentation vs Official Docs

From: "Joshua D(dot) Drake" <jd(at)commandprompt(dot)com>
To: "Psql_General (E-mail)" <pgsql-general(at)postgresql(dot)org>
Subject: User documentation vs Official Docs
Date: 2018-07-16 20:32:56
Message-ID: cd3dce29-fb92-54ce-2d5a-cfee66363f7f@commandprompt.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-general

-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?

Thanks!

JD

--
Command Prompt, Inc. || http://the.postgres.company/ || @cmdpromptinc
*** A fault and talent of mine is to tell it exactly how it is. ***
PostgreSQL centered full stack support, consulting and development.
Advocate: @amplifypostgres || Learn: https://postgresconf.org
***** Unless otherwise stated, opinions are my own. *****

Responses

Browse pgsql-general by date

  From Date Subject
Next Message Adrian Klaver 2018-07-16 20:39:16 Re: User documentation vs Official Docs
Previous Message Adrien NAYRAT 2018-07-16 15:44:48 Re: Query to monitor index bloat