From: | "Jonathan S(dot) Katz" <jonathan(dot)katz(at)excoventures(dot)com> |
---|---|
To: | Alvaro Herrera <alvherre(at)2ndquadrant(dot)com> |
Cc: | "Joshua D(dot) Drake" <jd(at)commandprompt(dot)com>, "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>, "Psql_General (E-mail)" <pgsql-general(at)postgresql(dot)org> |
Subject: | Re: User documentation vs Official Docs |
Date: | 2018-07-17 03:54:29 |
Message-ID: | 5C0154AA-3F81-4B46-8AB7-850FFEDFCC7D@excoventures.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-general |
> On Jul 16, 2018, at 8:08 PM, Alvaro Herrera <alvherre(at)2ndquadrant(dot)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:
https://www.postgresql.org/docs/online-resources/ <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
From | Date | Subject | |
---|---|---|---|
Next Message | Fabio Pardi | 2018-07-17 08:11:50 | Re: Query to monitor index bloat |
Previous Message | Igor Polishchuk | 2018-07-17 01:41:19 | How to create logical replication slot with NOEXPORT_SNAPSHOT in jdbc |