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

From Jonathan S. Katz
Subject Re: User documentation vs Official Docs
Date
Msg-id 5C0154AA-3F81-4B46-8AB7-850FFEDFCC7D@excoventures.com
Whole thread Raw
In response to Re: User documentation vs Official Docs  (Alvaro Herrera <alvherre@2ndquadrant.com>)
List pgsql-general

On Jul 16, 2018, at 8:08 PM, Alvaro Herrera <alvherre@2ndquadrant.com> 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:


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

pgsql-general by date:

Previous
From: Igor Polishchuk
Date:
Subject: How to create logical replication slot with NOEXPORT_SNAPSHOT in jdbc
Next
From: Fabio Pardi
Date:
Subject: Re: Query to monitor index bloat