Re: User documentation vs Official Docs

From: "Joshua D(dot) Drake" <jd(at)commandprompt(dot)com>
To: Adrian Klaver <adrian(dot)klaver(at)aklaver(dot)com>, "Psql_General (E-mail)" <pgsql-general(at)postgresql(dot)org>
Subject: Re: User documentation vs Official Docs
Date: 2018-07-16 20:48:37
Message-ID: eee3e4fd-82cf-a1f2-aa89-067ca68d1a5d@commandprompt.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-general

On 07/16/2018 01:39 PM, Adrian Klaver wrote:
>
> Not sure this is much different from the Wiki unless:

The wiki is certainly "a place" that can be used for this but the wiki
takes a lot of effort to find things on it, manage it etc...

> Who is going to?:
>
> 1) Run/maintain it.
>

Well this is a community. The hope would be that the community would
step up. As a proposer (and writer) I am certainly willing to participate.

> 2) Get people to contribute.

I don't think this is nearly as difficult except if we create artificial
barriers to contribution (writing in the wiki is a highly subpar
experience).

>
> 3) Edit new content, clean up old content
>

So some of this could be original content, some of it could just be
links to various blogs/articles that already exist and some could be
maintenance. However, I see maintenance as a secondary issue because we
would publish based on version. If someone wrote an article for 9.6 it
may or may not apply for 11 but that doesn't matter. People are always
generating new content.

JD

>
>
>>
>> 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. *****

In response to

Responses

Browse pgsql-general by date

  From Date Subject
Next Message Tom Lane 2018-07-16 20:58:15 Re: User documentation vs Official Docs
Previous Message Benjamin Scherrey 2018-07-16 20:47:30 Re: User documentation vs Official Docs