Re: User documentation vs Official Docs

["Jonathan S. Katz" <jonathan.katz@xxxxxxxxxxxxxxxx>]

On Jul 16, 2018, at 8:08 PM, Alvaro Herrera <alvherre@xxxxxxxxxxxxxxx> wrote:

On 2018-Jul-16, Joshua D. Drake wrote:

Think of this (if we can figure out how to pull this off): User on
StackOverflow says, "How do I do X", someone answers with a direct
link to a recipe on PostgreSQL.Org that tells them exactly how to do X
(with caveats of course).  There isn't much more user friendly than
that.

Sounds like wiki pages could solve need this pretty conveniently.  If
and when the content is mature enough and migrates to the tutorial main
documentation pages, the wiki pages can be replaced with redirects to
those.

We’ve also tried to use the website to point to some already existing

resources to learn PostgreSQL:

https://www.postgresql.org/docs/online-resources/

Some of these includes tutorials that people have put together. If other

resources exist, I’m sure the -www team would be happy to review and

add them. We could also consider renaming the page to make it more

clear that it links to tutorials and the like.

That said, I’m sure contributions to improving the tutorial in the docs

would be well received. I figure it would just take a bit of work from people

who want to add to it. I see it being no different than getting a large patch

in, just some collaborative efforts from people who want to make it better

and some community back-and-forth.

Jonathan