Re: TODO, FAQs to Wiki?

From: Magnus Hagander <magnus(at)hagander(dot)net>
To: "Joshua D(dot) Drake" <jd(at)commandprompt(dot)com>
Cc: Alvaro Herrera <alvherre(at)commandprompt(dot)com>, Bruce Momjian <bruce(at)momjian(dot)us>, PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: TODO, FAQs to Wiki?
Date: 2008-04-20 17:16:55
Message-ID: 20080420191655.41a18876@mha-laptop
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Joshua D. Drake wrote:
> Magnus Hagander wrote:
> > Alvaro Herrera wrote:
> >> The FAQs are another matter however. I suggested some time back
> >> moving those to DocBook XML. A friend was working on a script to
> >> do the initial conversion automatically. The nice thing about it
> >> is that we can then use the xml2po tools to create PO files for
> >> translation. This means that translations are more easily kept up
> >> to date. Are you open to this possibility?
> >
> > What would be the advantage of keeping it in DocBook over the wiki?
> > One of the main advantages of keeping it on the wiki would be to
> > allow others to help out with the editing of them.
>
> Two words:
>
> print format
>
> If we want to push the FAQ to the wiki, we should write a stylesheet
> that transforms the docbook to wiki output (wouldn't be surprised if
> such a beast already exists) but the source should be Docbook or ODF.

You're not actually claiming we have print format today, are you?

And have you actually *tried* printing something from the wiki? Doesn't
look so bad to me.

And do people really *print* something like a FAQ?

Anyway. If people want to build a more complex system to deal with the
user FAQs, be my guest. The developer FAQ is obviously a very different
thing from those.

//Magnus

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Jonah H. Harris 2008-04-20 17:20:29 Re: WAL files format
Previous Message Magnus Hagander 2008-04-20 17:13:54 Re: TODO, FAQs to Wiki?