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

[Russell Bryant]

On Wed, 2010-11-03 at 17:01 -0500, Russell Bryant wrote:
> 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...

I should also add that if network access is the issue, it is also
possible for users of the wiki to export the content at any time to PDF
for viewing offline.

-- 
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