<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta content="text/html;charset=ISO-8859-1" http-equiv="Content-Type">
<title></title>
</head>
<body bgcolor="#ffffff" text="#000000">
Jared Smith wrote:
<blockquote cite="mid:1233086796.7082.6.camel@frankenbox" type="cite">
<pre wrap="">On Tue, 2009-01-27 at 10:13 -0700, Robert Broyles wrote:
</pre>
<blockquote type="cite">
<pre wrap="">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.
</pre>
</blockquote>
<pre wrap=""><!---->
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.
</pre>
</blockquote>
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. <br>
<blockquote cite="mid:1233086796.7082.6.camel@frankenbox" type="cite">
<pre wrap=""></pre>
<blockquote type="cite">
<pre wrap="">(Unless one is willing to buy or read O'Reilly's Book -
<a class="moz-txt-link-freetext" href="http://www.asteriskdocs.org">http://www.asteriskdocs.org</a> - which quickly will be outdated again.)
</pre>
</blockquote>
<pre wrap=""><!---->
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!)
</pre>
</blockquote>
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. :-( <br>
<br>
<blockquote cite="mid:1233086796.7082.6.camel@frankenbox" type="cite">
<pre wrap=""></pre>
<blockquote type="cite">
<pre wrap="">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.
</pre>
</blockquote>
<pre wrap=""><!---->
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.
</pre>
</blockquote>
I'll be checking this out. <br>
</body>
</html>