[asterisk-doc] Who's Willing to Contribute ?
AsteriskDocs RoleAccount
asterisk-doc at ms.edu
Mon Feb 9 07:37:09 CST 2009
We would be willing to help with the proffreading. (that was intended as an arguably poor joke, of course!)
For example, Robert, anyone contemplating the preparation of documentation should be careful as to whether the correct term is "depreciated" or "deprecated".
-----Original Message-----
From: "Robert Broyles" <robert at poornam.com>
Sent 2/9/2009 8:19:01 AM
To: "Discussions regarding The Asterisk Documentation Project" <asterisk-doc at lists.digium.com>
Subject: Re: [asterisk-doc] Who's Willing to Contribute ?
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_______________________________________________
--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/3702626a/attachment-0001.htm
More information about the asterisk-doc
mailing list