Re: User documentation vs Official Docs

From: "Joshua D(dot) Drake" <jd(at)commandprompt(dot)com>
To: Stephen Frost <sfrost(at)snowman(dot)net>, Benjamin Scherrey <scherrey(at)proteus-tech(dot)com>
Cc: "Psql_General (E-mail)" <pgsql-general(at)postgresql(dot)org>
Subject: Re: User documentation vs Official Docs
Date: 2018-07-16 21:44:53
Message-ID: 65f362b0-b859-bf9b-a0dd-d9bbd6940dea@commandprompt.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-general

On 07/16/2018 02:22 PM, Joshua D. Drake wrote:
> On 07/16/2018 01:59 PM, Stephen Frost wrote:
>>
>> We have a place for this to go, in the official docs, already split out
>> by version, and it starts here:
>>
>> https://www.postgresql.org/docs/10/static/tutorial-start.html
>>
>> Adding more to that certainly sounds good to me.
>
> I didn't know that existed. I will take a look.

Well now that I see it is just the "tutorial" in the official docs, I
disagree that is the correct place to start. At least not if it is going
to ship with the 1000+ pages of documentation we already have. What I am
envisioning is something with a strong SEO that gives pointed and direct
information about solving a specific problem. A tutorial book could
certainly do that as could (what I am really talking about) is Postgres
recipes or something like that.

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 Alessandro Aste 2018-07-16 21:50:45 Re: Query to monitor index bloat
Previous Message Joshua D. Drake 2018-07-16 21:22:29 Re: User documentation vs Official Docs