[Nut-upsdev] Documentation-related questions

[Arnaud Quette]

2009/1/16 Eric S. Raymond <esr at snark.thyrsus.com>

> 3a. What part of the documentation needs the most immediate attention?
>
> 3b. Will anyone come after me with an axe if I move the entire corpus
> to ASCIIDOC markup?   http://www.methods.co.nz/asciidoc/
>
> 3c. Why isn't the content of the website a branch in the repo?  Can
> we fix things so it is?
>
> Hint: If the website becomes a repo branch, I'll reorganize and
> rewrite that for clarity, too.
>

first, a small sum up of the current status, past work and aims to
understand the situation:
- the doc need to be easily maintainable by a non tech guy (though I've
still not found anybody reliable enough for that),
- we need to provide at least an html output,
- many part of the contents of the website and inline doc (ie the docs/
directory of the source tree) are either redundant or missing on one side or
the other,
- considering all the above point, I started the
http://test.networkupstools.org website, with a consolidated approach. This
is still a work underway though (or somewhat a failure!)
- the final system should fit the above, and allow to be used online (for
the website) and offline (for the source distribution and packages). It
should also allow a split between a User Manual, a Developer Manual,
- your above ASCIIDOC approach seems really interesting (and more than a raw
docbook approach!) and possibly meeting all the requirement.

So, I would really like to investigate this a bit more with you ^_^

Thanks a lot for being back Eric, I (and the NUT team and users I'm sure)
very much appreciate!

cheers,
Arnaud
-- 
Linux / Unix Expert R&D - Eaton - http://www.eaton.com/mgeops
Network UPS Tools (NUT) Project Leader - http://www.networkupstools.org/
Debian Developer -
http://people.debian.org/~aquette/<http://people.debian.org/%7Eaquette/>
Free Software Developer - http://arnaud.quette.free.fr/
--
Conseiller Municipal - Saint Bernard du Touvet -
http://www.SaintBernardDuTouvet.fr/
en charge de la Communication, de l'Informatique et des Technologies
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.alioth.debian.org/pipermail/nut-upsdev/attachments/20090116/3442f0b2/attachment.htm