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

[Hans Witvliet]

On Thu, 2010-11-04 at 08:07 +0100, Olle E. Johansson wrote:
> 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.
> 

Indeed,

Sometimes you can (ask to) print out relevant wiki-pages, and then
finding out that due to the misuse of scroll-bars, you miss half of the
example.

Or even worse: man/info-pages that ONLY refer to an webpage, while bwing
located in an area without internet access.

hw