[asterisk-dev] doc/ -> wiki.asterisk.org

Russell Bryant russell at digium.com
Wed Nov 3 17:01:19 CDT 2010


On Wed, 2010-11-03 at 22:31 +0100, Olle E. Johansson wrote:
> I think we need to be careful with documents that are needed in install and basic configuration.
> I always use the channelvariables document in text format and it needs to be there, hopefully also in the svn versions.

> I love wikis, but as Klaus said, they are NOT reachable in many, many cases where we install the software.
> Use them for examples and keep the reference in the source tree. We also use some text files as includes
> in the doxygen. Make copies of it the same way for the wiki - without allowing edits - just comments.

I certainly understand that installations are done on servers without a
graphical interface.  However, it is really hard for me to believe that
access to web based documentation via another machine is impractical.
It's 2010, access to a web browser seems to be pretty common at this
point...

-- 
Russell Bryant
Digium, Inc.  |  Engineering Manager, Open Source Software
445 Jan Davis Drive NW   -    Huntsville, AL 35806  -  USA
jabber: rbryant at digium.com    -=-    skype: russell-bryant
www.digium.com -=- www.asterisk.org -=- blogs.asterisk.org





More information about the asterisk-dev mailing list