[asterisk-doc] Who's Willing to Contribute ?
Robert Broyles
robert at poornam.com
Mon Feb 9 07:19:01 CST 2009
Sorry in advance for any grammer/spelling mistakes. (I've been at it for
almost 18 hours now.)
My thoughts are basically this...
1) We can start from scratch, and create a new single wiki, which is
recognized as the most comprehensive guide to Asterisk.
2) We can expand further on voip-info.org.
Regardless of which option we do, regular 'audits' of the documentation
is done, to ensure that the latest and most accurate information is
available.
What information will be available?
Everything about Asterisk.
- Guide to setup/install of Asterisk (Using the Realtime Engine,
AEL, etc)
- Troubleshooting/debugging guide, common issues and their
resolution, etc
- Each dialplan application, explanation of it's use, it's
parameters/options, examples of use.
- depreciated functions, and detailed alternative methods
Some of this stuff seems silly, but the point it to make the information
available to even the newbies. Someone mentioned in a previous thread
that alot of the information on voip-info.org is written for advanced
users, and it assumes too much about the reader, and their skillset.
This only leads to more silly questions from the reader.
Anyway, this is my start. I am at least attempting to improve the
documentation on Asterisk. Anyone go any other suggestions?
--
Regards,
Robert Broyles
john maclean wrote:
> I'd love to contribute with the little that I know. What exactly are
> you looking for? A supplement to the existing docs and man pages
> or...?
>
> 2009/2/9 Robert Broyles <robert at poornam.com>:
>
>> Seems this message didn't go through the first time. If you get it a
>> second time, I'm sorry.
>>
>> ============
>>
>> A few weeks ago, in the users lists, I was speaking about the lack of
>> proper documentation regarding Asterisk. While there is the Asterisk
>> Bible (http://asteriskdocs.org) - great read by the way ... and there's
>> voip-info.org - there isn't really a good source for comprehensive
>> documentation on Asterisk.
>>
>> With that in mind, our organization is prepared to sponsor a project
>> such as this. However, we're looking to know how much contribution the
>> community is willing to give.
>>
>> I look forward to hearing everyone's feedback in this regard. Thanks in
>> advance for your time.
>>
>> --
>> Regards,
>> Robert Broyles
>> Poornam Inc aka Bobcares
>> Phoenix, Arizona, USA 602.288.9145
>>
>> _______________________________________________
>> --Bandwidth and Colocation Provided by http://www.api-digital.com--
>>
>> asterisk-doc mailing list
>> To UNSUBSCRIBE or update options visit:
>> http://lists.digium.com/mailman/listinfo/asterisk-doc
>>
>>
>
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.digium.com/pipermail/asterisk-doc/attachments/20090209/27d90fd9/attachment.htm
More information about the asterisk-doc
mailing list