docs (was Re: [Nut-upsdev] Re: [nut-commits] svn commit r831 - in trunk: .)

[Arnaud Quette]

2007/3/3, Charles Lepple <clepple at gmail.com>:
> On 3/3/07, Arnaud Quette <aquette.dev at gmail.com> wrote:
> > Lastly, yep the doc is still unsynced, ugly and incomplete :(
> > I've recruited 3 people of which none is active.
>
> I still think we need something simpler than docbook.
>
> Suggestions?

I don't think the problem lies in docbook itself, but more in the lack
of docbook [wysiwyg] GUIs to create and maintain the doc.

docbook is powerful at generating different output format, and since
it's in xml/sgml (so text based), it's svn compliant and is a somewhat
open standard.

Other solution I've seen are Tex, html or proprietary. So even less
friendly / maintainable.

but IANADW (I Am Not A Doc Writer)... so a more knowledgeable people
might have better ideas.

Arnaud
-- 
Linux / Unix Expert - MGE UPS SYSTEMS - R&D Dpt
Network UPS Tools (NUT) Project Leader - http://www.networkupstools.org/
Debian Developer - http://people.debian.org/~aquette/
OpenSource Developer - http://arnaud.quette.free.fr/