Re: User documentation vs Official Docs

From: Adrian Klaver <adrian(dot)klaver(at)aklaver(dot)com>
To: "Joshua D(dot) Drake" <jd(at)commandprompt(dot)com>, "Psql_General (E-mail)" <pgsql-general(at)postgresql(dot)org>
Subject: Re: User documentation vs Official Docs
Date: 2018-07-16 20:39:16
Message-ID: e91b5f21-71b4-106b-5ec7-1c71ff1849b0@aklaver.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-general

On 07/16/2018 01:32 PM, Joshua D. Drake 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?

Not sure this is much different from the Wiki unless:

Who is going to?:

1) Run/maintain it.

2) Get people to contribute.

3) Edit new content, clean up old content

>
> Thanks!
>
> JD
>
>

--
Adrian Klaver
adrian(dot)klaver(at)aklaver(dot)com

In response to

Responses

Browse pgsql-general by date

  From Date Subject
Next Message Thomas Kellerer 2018-07-16 20:46:11 Re: User documentation vs Official Docs
Previous Message Joshua D. Drake 2018-07-16 20:32:56 User documentation vs Official Docs