| From: | Greg Smith <gsmith(at)gregsmith(dot)com> |
|---|---|
| To: | Tino Wildenhain <tino(at)wildenhain(dot)de> |
| Cc: | Alvaro Herrera <alvherre(at)commandprompt(dot)com>, PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org> |
| Subject: | Re: TODO, FAQs to Wiki? |
| Date: | 2008-04-21 17:29:59 |
| Message-ID: | Pine.GSO.4.64.0804211323260.3269@westnet.com |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-hackers |
On Mon, 21 Apr 2008, Tino Wildenhain wrote:
>>> Alvaro Herrera wrote:
>> I suggest we start an experiment with the FAQ in XML Docbook, which is
>> amenable to automatic processing, and move from there.
>>
> Well... or reStructuredText which has the advantage of beeing human
> editable? (without specialized editor that is)
reST is a reasonable tool for building small documents, I don't use it
because it really doesn't scale well to handle larger ones. Given that
the rest of the project is already committed to using Docbook for those
larger documents, I think it's hard to justify the additional toolchain
needed for reST processing just to make the FAQ a little easier to edit.
--
* Greg Smith gsmith(at)gregsmith(dot)com http://www.gregsmith.com Baltimore, MD
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Tom Lane | 2008-04-21 17:33:03 | Re: Regression test fails when BLCKSZ is 1kB |
| Previous Message | Pavan Deolasee | 2008-04-21 17:29:14 | Re: Regression test fails when BLCKSZ is 1kB |