[asterisk-doc] asterisk-doc Digest, Vol 35, Issue 1
Randy Bell
rbell at digium.com
Mon Feb 9 08:06:06 CST 2009
unsubscribe
-----Original Message-----
From: asterisk-doc-bounces at lists.digium.com
[mailto:asterisk-doc-bounces at lists.digium.com] On Behalf Of
asterisk-doc-request at lists.digium.com
Sent: Monday, February 09, 2009 7:37 AM
To: asterisk-doc at lists.digium.com
Subject: asterisk-doc Digest, Vol 35, Issue 1
Send asterisk-doc mailing list submissions to
asterisk-doc at lists.digium.com
To subscribe or unsubscribe via the World Wide Web, visit
http://lists.digium.com/mailman/listinfo/asterisk-doc
or, via email, send a message with subject or body 'help' to
asterisk-doc-request at lists.digium.com
You can reach the person managing the list at
asterisk-doc-owner at lists.digium.com
When replying, please edit your Subject line so it is more specific
than "Re: Contents of asterisk-doc digest..."
Today's Topics:
1. Who's Willing to Contribute ? (Robert Broyles)
2. Who's Willing to Contribute ? (Robert Broyles)
3. Re: Who's Willing to Contribute ? (john maclean)
4. Re: Who's Willing to Contribute ? (Chris Tooley)
5. Re: Who's Willing to Contribute ? (Robert Broyles)
6. Re: Who's Willing to Contribute ? (AsteriskDocs RoleAccount)
----------------------------------------------------------------------
Message: 1
Date: Mon, 09 Feb 2009 03:48:31 -0700
From: Robert Broyles <robert at poornam.com>
Subject: [asterisk-doc] Who's Willing to Contribute ?
To: asterisk-doc at lists.digium.com
Message-ID: <499009FF.4030501 at poornam.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
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 google 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
------------------------------
Message: 2
Date: Mon, 09 Feb 2009 04:00:44 -0700
From: Robert Broyles <robert at poornam.com>
Subject: [asterisk-doc] Who's Willing to Contribute ?
To: asterisk-doc at lists.digium.com
Message-ID: <49900CDC.8040808 at poornam.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
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
------------------------------
Message: 3
Date: Mon, 9 Feb 2009 12:22:51 +0000
From: john maclean <jayeola at gmail.com>
Subject: Re: [asterisk-doc] Who's Willing to Contribute ?
To: Discussions regarding The Asterisk Documentation Project
<asterisk-doc at lists.digium.com>
Message-ID:
<4170c1720902090422y40615a1el88104f06a6cd3701 at mail.gmail.com>
Content-Type: text/plain; charset=ISO-8859-1
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
>
--
John Maclean
07739 171 531
MSc (DIC)
Timezone: GMT
------------------------------
Message: 4
Date: Mon, 9 Feb 2009 06:39:40 -0600
From: Chris Tooley <ctooley at gmail.com>
Subject: Re: [asterisk-doc] Who's Willing to Contribute ?
To: Discussions regarding The Asterisk Documentation Project
<asterisk-doc at lists.digium.com>
Message-ID:
<ec309a00902090439j7692847bu85672d711b5b8d1d at mail.gmail.com>
Content-Type: text/plain; charset=ISO-8859-1
There is an online version of The Book available as well at:
http://downloads.oreilly.com/books/9780596510480.pdf
Jim, Jared and Leif have spent a considerable amount of time on
documentation, buying the book supports their time contribution to the
documentation project.
On Mon, Feb 9, 2009 at 6:22 AM, john maclean <jayeola at gmail.com> 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
>>
>
>
>
> --
> John Maclean
> 07739 171 531
> MSc (DIC)
>
> Timezone: GMT
>
> _______________________________________________
> --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
>
------------------------------
Message: 5
Date: Mon, 09 Feb 2009 06:19:01 -0700
From: Robert Broyles <robert at poornam.com>
Subject: Re: [asterisk-doc] Who's Willing to Contribute ?
To: Discussions regarding The Asterisk Documentation Project
<asterisk-doc at lists.digium.com>
Message-ID: <49902D45.5060204 at poornam.com>
Content-Type: text/plain; charset="iso-8859-1"
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/27d90f
d9/attachment-0001.htm
------------------------------
Message: 6
Date: Mon, 09 Feb 2009 13:37:09 GMT
From: "AsteriskDocs RoleAccount" <asterisk-doc at ms.edu>
Subject: Re: [asterisk-doc] Who's Willing to Contribute ?
To: "Discussions regarding The Asterisk Documentation Project"
<asterisk-doc at lists.digium.com>
Message-ID: <200902090837942.SM05328@[64.137.8.19]>
Content-Type: text/plain; charset="utf-8"
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/370262
6a/attachment.htm
------------------------------
_______________________________________________
--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
End of asterisk-doc Digest, Vol 35, Issue 1
*******************************************
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.digium.com/pipermail/asterisk-doc/attachments/20090209/f20ba2b2/attachment-0001.htm
More information about the asterisk-doc
mailing list