Re: TODO, FAQs to Wiki?

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Alvaro Herrera <alvherre(at)commandprompt(dot)com>
Cc: PostgreSQL-development <pgsql-hackers(at)postgreSQL(dot)org>
Subject: Re: TODO, FAQs to Wiki?
Date: 2008-04-19 15:54:34
Message-ID: 200804191554.m3JFsYs19473@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Alvaro Herrera wrote:
> Bruce Momjian wrote:
> > I am impressed at the state of the May wiki patch queue:
> >
> > http://wiki.postgresql.org/wiki/CommitFest:May
> >
> > It is even tracking the psql wrap patch I am working on now.
>
> Thanks. We've put a certain amount of effort on it. Credit for the
> templating system goes to Brendan Jurd, who implemented the way to make
> it display as tables but without the messy markup. I think the
> templates that are now in place make for a reasonably comfortable
> environment. Not as simple as editing a plain text file, but I expect
> it is lean enough.

Yes, I was surprised at the sophistication of the layout.

> > Magnus has started moving the Developer's FAQ to a wiki. I am thinking
> > we should move the main FAQ and the TODO list to a wiki as well if the
> > community is in agreement.
>
> Having the TODO on the wiki makes plenty of sense IMHO. Magnus showed
> me an experiment some time ago and it looked good (modulo some errors in
> the conversion, but I think that's to be expected.)

Yes, he showed me too. I was worried no one but me would update it but
at this point I think others will get involved.

> 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?

Yes. The FAQ's change very infrequently, and XML would be fine for
those, especially since it would lessen the translation load.

--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Joshua D. Drake 2008-04-19 15:58:14 Re: TODO, FAQs to Wiki?
Previous Message Joshua D. Drake 2008-04-19 15:50:28 Re: get rid of psql welcome message