<br><div class="gmail_quote">2009/1/16 Eric S. Raymond <span dir="ltr"><<a href="mailto:esr@snark.thyrsus.com" target="_blank">esr@snark.thyrsus.com</a>></span><br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
3a. What part of the documentation needs the most immediate attention?<br>
<br>
3b. Will anyone come after me with an axe if I move the entire corpus<br>
to ASCIIDOC markup? <a href="http://www.methods.co.nz/asciidoc/" target="_blank">http://www.methods.co.nz/asciidoc/</a><br>
<br>
3c. Why isn't the content of the website a branch in the repo? Can<br>
we fix things so it is?<br>
<br>
Hint: If the website becomes a repo branch, I'll reorganize and<br>
rewrite that for clarity, too.<br>
</blockquote></div><br>first, a small sum up of the current status, past work and aims to understand the situation:<br>- the doc need to be easily maintainable by a non tech guy (though I've still not found anybody reliable enough for that),<br>
- we need to provide at least an html output,<br>- 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,<br>- considering all the above point, I started the <a href="http://test.networkupstools.org">http://test.networkupstools.org</a> website, with a consolidated approach. This is still a work underway though (or somewhat a failure!)<br>
- 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,<br>- your above ASCIIDOC approach seems really interesting (and more than a raw docbook approach!) and possibly meeting all the requirement.<br>
<br>So, I would really like to investigate this a bit more with you ^_^<br><br>Thanks a lot for being back Eric, I (and the NUT team and users I'm sure) very much appreciate!<br><br clear="all">cheers,<br>Arnaud<br>-- <br>
Linux / Unix Expert R&D - Eaton - <a href="http://www.eaton.com/mgeops" target="_blank">http://www.eaton.com/mgeops</a><br>Network UPS Tools (NUT) Project Leader - <a href="http://www.networkupstools.org/" target="_blank">http://www.networkupstools.org/</a><br>
Debian Developer - <a href="http://people.debian.org/%7Eaquette/" target="_blank">http://people.debian.org/~aquette/</a><br>Free Software Developer - <a href="http://arnaud.quette.free.fr/" target="_blank">http://arnaud.quette.free.fr/</a><br>
--<br>Conseiller Municipal - Saint Bernard du Touvet -<br>
<a href="http://www.SaintBernardDuTouvet.fr/" target="_blank">http://www.SaintBernardDuTouvet.fr/</a><br>en charge de la Communication, de l'Informatique et des Technologies<br>