<br><br><div class="gmail_quote">2009/1/20 Eric S. Raymond <span dir="ltr">&lt;<a href="mailto:esr@thyrsus.com" target="_blank">esr@thyrsus.com</a>&gt;</span><br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">

<div>Arnaud Quette &lt;<a href="mailto:aquette.dev@gmail.com" target="_blank">aquette.dev@gmail.com</a>&gt;:<br>
</div><div>&gt; well, I&#39;ve thought a bit about that in the past days, and I&#39;m obviously<br>
&gt; going for #1 (in-tree).<br>
&gt; but I think with a slight variation: a few pieces don&#39;t need (and even more,<br>
&gt; must not) be in the source tree. This is mostly the Homepage and Protocol<br>
&gt; library (== everything not under Documentation in the wiki ; I&#39;ve started to<br>
&gt; reorganize this last with that idea in mind, but it&#39;s not finished).<br>
&gt; You can have an idea of this by mousing over the wiki menu...<br>
&gt;<br>
&gt; The website is then a base container (homepage + menu) with pointers to the<br>
&gt; online documentation.<br>
&gt;<br>
&gt; so I&#39;m thinking about trimming it to that simple base. The wiki may then be<br>
&gt; superfluous (I&#39;m hesitating due to i18n, which is another target), and a<br>
&gt; static set might do the trick.<br>
&gt;<br>
&gt; we will need to talk / think a bit more to refine the final solution, but<br>
&gt; this looks really promising ^_^<br>
<br>
</div>Your having made the basic decision helps a lot. &nbsp;It means I can get started on<br>
moving the in-tree documentation to asciidoc, revising it as necessary.<br>
Tinkering with the wiki and what stays in it can come later.<br>
<div></div></blockquote><div><br>another note I seem to have forgotten is that, beside the User and Developer Manual split, a general reorganization of the doc (and its content) was planned to consolidate, complement and simplify these.<br>
So far, the new tree looks&nbsp; like:<br><a href="http://test.networkupstools.org/Documentation/UserManual" target="_blank">http://test.networkupstools.org/Documentation/UserManual</a><br>
<br>I also have a few draft notes on the Developer Manual if/when needed.<br>as stated before, the aim is to have the things that are only online atm, back into the doc. so that in the end we only have to use pointer to these from the website skeleton.<br>
<br></div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"><div>

&gt; I&#39;ll postpone a bit more these discussions to concentrate on the various<br>
&gt; mentioned tasks. we can still continue to talk, but I won&#39;t be much<br>
&gt; responsive atm.<br>
<br>
</div>I&#39;ll have enough to work on until Thursday, then I&#39;ll be traveling until<br>
the following Tuesday. &nbsp;We can resume this discussion after next week.<br>
<font color="#888888"></font></blockquote><div><br>perfect timing!<br></div></div><br clear="all">don&#39;t hesitate to ping me if you have any questions / doubt in the meantime.<br>
I&#39;ll do my best to prioritize this important subject to has been neglected for too long!<br><br>cheers,<br>Arnaud<br>