Re: User documentation vs Official Docs

From: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>
To: "Joshua D(dot) Drake" <jd(at)commandprompt(dot)com>, Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>
Cc: "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 11:47:48
Message-ID: 375d55b8-1190-c9f4-febc-b19931e8f9ce@2ndquadrant.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-general

On 17.07.18 02:13, Joshua D. Drake wrote:
> On 07/16/2018 05:08 PM, Alvaro Herrera wrote:
>>
>> 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.
>
> Anyone who writes a lot is going to rebel against using a wiki. They are
> one of the worst to write in from a productivity perspective. I would
> rather write in Docbook, at least then I can template everything and we
> could have a standard xsl sheet etc...

I don't really buy that. The wiki seems just fine for writing short to
medium size how-to type articles. We already have good content of that
sort in the wiki right now. It's not like there isn't going to be
anyone who will rebel against any of the other tool chains that have
been mentioned.

--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

In response to

Responses

Browse pgsql-general by date

  From Date Subject
Next Message Magnus Hagander 2018-07-17 12:04:26 Re: User documentation vs Official Docs
Previous Message Peter Eisentraut 2018-07-17 11:29:50 Re: How to create logical replication slot with NOEXPORT_SNAPSHOT in jdbc