Re: User documentation vs Official Docs - Mailing list pgsql-general

From Vick Khera
Subject Re: User documentation vs Official Docs
Date
Msg-id CALd+dcdnLtX0+icgAVFXpMfMURNkfO=y+wM_RQtCJnyNw81Rpg@mail.gmail.com
Whole thread Raw
In response to Re: User documentation vs Official Docs  ("Joshua D. Drake" <jd@commandprompt.com>)
Responses Re: User documentation vs Official Docs  ("Joshua D. Drake" <jd@commandprompt.com>)
Re: User documentation vs Official Docs  (Stephen Frost <sfrost@snowman.net>)
List pgsql-general

On Mon, Jul 16, 2018 at 5:44 PM, Joshua D. Drake <jd@commandprompt.com> wrote:
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.


 
I didn't know it existed either, mostly because I know how to ask google to do things, and the things I need to know are not covered here (yet). This does seem to me to be the ideal place to add more how to documentation to augment all the reference docs we have.

As for some "strong SEO" I think already the top hit for almost everything I seek postgres related is the official manual, so it seems to have good SEO. The only big improvement would be somehow to tell google to only show me the newest version of the manual, not all of the older ones too, for the same page.

pgsql-general by date:

Previous
From: Alessandro Aste
Date:
Subject: Re: Query to monitor index bloat
Next
From: "Joshua D. Drake"
Date:
Subject: Re: User documentation vs Official Docs