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

[Chris Tooley]

Sorry for the top-post, my phone won't let me do anything else.

However, my one reason for have plain text documentation with the source
code... grep
On Nov 3, 2010 5:15 PM, "Russell Bryant" <russell at digium.com> wrote:
> 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
>
>
>
> --
> _____________________________________________________________________
> -- Bandwidth and Colocation Provided by http://www.api-digital.com --
>
> asterisk-dev mailing list
> To UNSUBSCRIBE or update options visit:
> http://lists.digium.com/mailman/listinfo/asterisk-dev
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.digium.com/pipermail/asterisk-dev/attachments/20101103/a5d1e5b2/attachment.htm