<p>Sorry for the top-post, my phone won't let me do anything else.</p>
<p>However, my one reason for have plain text documentation with the source code... grep</p>
<div class="gmail_quote">On Nov 3, 2010 5:15 PM, "Russell Bryant" <<a href="mailto:russell@digium.com">russell@digium.com</a>> wrote:<br type="attribution">> On Wed, 2010-11-03 at 17:01 -0500, Russell Bryant wrote:<br>
>> On Wed, 2010-11-03 at 22:31 +0100, Olle E. Johansson wrote:<br>>> > I think we need to be careful with documents that are needed in install and basic configuration.<br>>> > I always use the channelvariables document in text format and it needs to be there, hopefully also in the svn versions.<br>
>> <br>>> > I love wikis, but as Klaus said, they are NOT reachable in many, many cases where we install the software.<br>>> > Use them for examples and keep the reference in the source tree. We also use some text files as includes<br>
>> > in the doxygen. Make copies of it the same way for the wiki - without allowing edits - just comments.<br>>> <br>>> I certainly understand that installations are done on servers without a<br>>> graphical interface. However, it is really hard for me to believe that<br>
>> access to web based documentation via another machine is impractical.<br>>> It's 2010, access to a web browser seems to be pretty common at this<br>>> point...<br>> <br>> I should also add that if network access is the issue, it is also<br>
> possible for users of the wiki to export the content at any time to PDF<br>> for viewing offline.<br>> <br>> -- <br>> Russell Bryant<br>> Digium, Inc. | Engineering Manager, Open Source Software<br>> 445 Jan Davis Drive NW - Huntsville, AL 35806 - USA<br>
> jabber: <a href="mailto:rbryant@digium.com">rbryant@digium.com</a> -=- skype: russell-bryant<br>> <a href="http://www.digium.com">www.digium.com</a> -=- <a href="http://www.asterisk.org">www.asterisk.org</a> -=- <a href="http://blogs.asterisk.org">blogs.asterisk.org</a><br>
> <br>> <br>> <br>> -- <br>> _____________________________________________________________________<br>> -- Bandwidth and Colocation Provided by <a href="http://www.api-digital.com">http://www.api-digital.com</a> --<br>
> <br>> asterisk-dev mailing list<br>> To UNSUBSCRIBE or update options visit:<br>> <a href="http://lists.digium.com/mailman/listinfo/asterisk-dev">http://lists.digium.com/mailman/listinfo/asterisk-dev</a><br>
</div>