[asterisk-users] RFC -- Improving the quality of the mailing lists

[Mik Cheez]

Don't over think this, guys.  Again, the point of having a WIKI is to 
allow for customization.  A landing page for Asterisk documentation 
within voip-info.org is all you need, not a whole new source of 
documentation.

Jai Rangi wrote:
> **********
> I understand. As someone else already mentioned, Voip-Info.org is for 
> more than just Asterisk. Perhaps if we created a single source that was 
> just for Asterisk...where everyone could contribute towards making the 
> documentation better. I would be very interested in helping sponsoring 
> such a project, just so long as we have enough contributors.
> **********
> We have some documentation and I can contribute that. Also we can 
> provide the physical resources (Domain, Web hosting, bandwidth, storage, 
> database etc). Ofcourse need a team with designated responsibilities.
> 
> -Jai Rangi
> www.didforsale.com <http://www.didforsale.com>
> 
> 
> 
> On Tue, Jan 27, 2009 at 1:16 PM, Robert Broyles <robert at poornam.com 
> <mailto:robert at poornam.com>> wrote:
> 
>     Jared Smith wrote:
>>     On Tue, 2009-01-27 at 10:13 -0700, Robert Broyles wrote:
>>       
>>>     I'm still pretty new to the mailing lists myself. I don't consider
>>>     myself a novice Asterisk user, but one of my biggest 'complaints' is
>>>     the lack of a well documented FAQ or Manual for Asterisk. 
>>>         
>>     Asterisk is truly an open-source community, and that pertains to
>>     documentation as well.  The quality and quantity of the documentation
>>     depends heavily on contribution from the community at large.  Digium has
>>     and will continue to put resources towards Asterisk documentation, but
>>     every contribution from the community at large helps.
>>
>>       
>     I understand. As someone else already mentioned, Voip-Info.org is
>     for more than just Asterisk. Perhaps if we created a single source
>     that was just for Asterisk...where everyone could contribute towards
>     making the documentation better. I would be very interested in
>     helping sponsoring such a project, just so long as we have enough
>     contributors.
>>>     (Unless one is willing to buy or read O'Reilly's Book -
>>>     http://www.asteriskdocs.org - which quickly will be outdated again.)  
>>>         
>>     Alas, you've mentioned the one thing that both makes me happy and sad at
>>     the same time.  Happy that people find it useful, and that O'Reilly was
>>     kind enough to let us publish it under a Creative Commons license (and
>>     put the PDF on the web for free!)... and sad that it takes so much time
>>     and effort to keep up to date.  (And just for the record, the time that
>>     the other authors and I spend on writing the O'Reilly book is our own
>>     personal time -- I'm not working on it during company time!)
>>
>>       
>     This was an excellent read. I'm sad to say that I was one that
>     didn't purchase the book, but made good use of the PDF. I was hoping
>     to win one of the books during your sessions at AstriCon this past
>     year.  Too bad. :-(
> 
>>>     I have made it a personal aim to document all my findings in a blog,
>>>     so that it's at least searchable by others through Google, in hopes
>>>     that others might find it useful.
>>>
>>>     But if we had a REGULARLY updated FAQ/Manual ... I think that would
>>>     greatly cut down on the clutter posts. 
>>>         
>>     If you're interested and serious about writing, join the asterisk-docs
>>     mailing list and let's try to get something started.  I've been beating
>>     the documentation drum for almost seven years now, and I'd love to see
>>     the -docs mailing list come back to life.
>>
>>       
>     I'll be checking this out.
> 
>     _______________________________________________
>     -- Bandwidth and Colocation Provided by http://www.api-digital.com --
> 
>     asterisk-users mailing list
>     To UNSUBSCRIBE or update options visit:
>       http://lists.digium.com/mailman/listinfo/asterisk-users
> 
> 
> 
> ------------------------------------------------------------------------
> 
> _______________________________________________
> -- Bandwidth and Colocation Provided by http://www.api-digital.com --
> 
> asterisk-users mailing list
> To UNSUBSCRIBE or update options visit:
>    http://lists.digium.com/mailman/listinfo/asterisk-users