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

[Olle E. Johansson]

3 nov 2010 kl. 23.01 skrev Russell Bryant:

> 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 guess you haven't spent hours in a datacenter bunker with no 3G access and no free IP for a laptop or policies that prevent attaching any laptops to the network.

Just believe us, we do need text format on the servers.

/O