[Asterisk-Users] Asterisk Documentation

[Thorsten Neumann]

I agree on the aspects of documentation. 

However, my inset is that most of the basic functions (e.g. an example
dialplan) can be found on the net.

Since I am interested in building a powerful and usable VoIP gateway, I
would like to see more of the subtler and not so often exposed functions
build into *. 

To name some, commands such as: Queue, AgentLogin, Monitor, ParkedCalls are
not within the currently available Asterisk Handbook and took some searching
to find examples...

Couldn't these commands be collected and centralized?

/tozzi

> -----Original Message-----
> From: asterisk-users-admin at lists.digium.com [mailto:asterisk-users-
> admin at lists.digium.com] On Behalf Of Roderick Montgomery
> Sent: 01 October 2003 02:47 PM
> To: asterisk-users at lists.digium.com
> Subject: Re: [Asterisk-Users] Asterisk Documentation
> 
> According to Daniel.Sloan at vu.edu.au:
> >
> > Does anybody have any thoughts on this plan, or better ideas?
> > Negative/positive thoughts about Doxygen?
> > Most importantly, is anyone else working on something along these lines
> > already?
> 
> Daniel,
> 
> Documentation is much-needed, and I'm glad to hear that there's someone
> else
> working on it. I'm working privately on an Asterisk Guide, with a target
> audience of administrators and users. Aside from the AGI interface for
> integration with basic scripting languages, I'm not focusing at all on
> documenting Asterisk code development. It's not something I understand
> well
> myself, the target audience of Asterisk developers is small relative to
> admins and users, and development is already well-supported with the
> Asterisk-Dev list.
> 
> Printed documentation seems most lacking for new users wanting to install
> Asterisk and set up a basic dialplan. By my estimation, many of the
> newcomers interested to Asterisk will have some basic knowledge of Unix or
> Linux, familiarity with the concept of OpenSource, and a willingness to
> try.
> I plan to provide a book that will guide them to a successful, usable
> installation with diagrams, examples, and design hints. The handbook, the
> wiki, the mailing list, and various personal websites with asterisk tips
> and
> examples are a great help, but separately do not provide a cohesive
> resource
> for teaching or reference. Frequently on the mailing list we see questions
> that are answered in one resource, while the well-intentioned newbie was
> looking at other Asterisk resources. I am attempting to write a
> comprehensive guide for administrators and users.
> 
> rm
> -------------------------------------------------------------------------
>  Roderick Montgomery   rod at thecomplex.com   <URL:http://thecomplex.com/>
> the fool stands only to fall, but the wise trip on grace... [Sarah Masen]
> -------------------------------------------------------------------------
> _______________________________________________
> Asterisk-Users mailing list
> Asterisk-Users at lists.digium.com
> http://lists.digium.com/mailman/listinfo/asterisk-users