Re: User documentation vs Official Docs

On 07/16/2018 04:33 PM, Adrian Klaver wrote:
>
>> First, my assumption is that this project would be done within the 
>> .Org infrastructure and if the community thinks that we should just 
>> use DocBook that is certainly an option (although adhering to 
>> something like Docbook Simple may be best).
>
> All the above is cool and everything, but is putting the cart before 
> the horse. To me to make this work the following needs to happen:
>
> 1) Create an editorial board. This group of people would determine the 
> answers to the questions above. They would also develop the framework 
> for what needs covered. This would be based on what users want to see. 
> Then a call for contributors could be made.
>
> 2) The other thing the editorial board would do is create list of 
> qualified peer reviewers. These folks would then review the 
> contributions and give feedback. On successfully passing a review a 
> contribution would go into the documentation.
>
> 3) Some combination of the editorial board/peer reviewers/other 
> volunteers would periodically go over existing documentation to 
> remove/update stale content.

I did it! Want to help? I think if we got together 5-7 people and came 
up with a proposal we could submit to -www/-core and get some buy in.

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