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: [EMAIL PROTECTED] [mailto:asterisk-users- > [EMAIL PROTECTED] On Behalf Of Roderick Montgomery > Sent: 01 October 2003 02:47 PM > To: [EMAIL PROTECTED] > Subject: Re: [Asterisk-Users] Asterisk Documentation > > According to [EMAIL PROTECTED]: > > > > 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 [EMAIL PROTECTED] <URL:http://thecomplex.com/> > the fool stands only to fall, but the wise trip on grace... [Sarah Masen] > ------------------------------------------------------------------------- > _______________________________________________ > Asterisk-Users mailing list > [EMAIL PROTECTED] > http://lists.digium.com/mailman/listinfo/asterisk-users _______________________________________________ Asterisk-Users mailing list [EMAIL PROTECTED] http://lists.digium.com/mailman/listinfo/asterisk-users