asterisk users - Nov 2010 - Why doesn't Asterisk project document certain important features of Asterisk officially?

Hi Everyone,

I am wondering why documentation of some of the vital parts of Asterisk is
hosted on voipinfo.org (unreliable is some parts) and not on asterisk.org?
For example the list of AMI events are not well documented and one has to
guess which version supports which event. The documentation file for AMI for
Asterisk 1.4 is really only a startup guide and it doesn't even provide a
full list available events.

I am wondering if this is a labor tedious job for the programmers or is it a
tactical move in part of a party with some sort of interest? Because the
programmer(s) who does the programming for something like the AMI events may
as well do something known as Copy & Paste (very easy process of pressing
keys: Ctrl+C + Ctrl+V) of what s/he has changed in the source code and make
it available in a text document without much fancy editing even.

This is not to bash the Asterisk project or Digium. Don't respond if you
have a difference of opinion as I am not looking for personal opinions but
rather JUST WONDERING THE TECHNICAL/TACTICAL CAUSE of not documenting thing
that are really hidden from the community and one has to go through a much
manual process to find out about.

Thanks for the input.

-Bruce
-------------- next part --------------
An HTML attachment was scrubbed...
URL:
http://lists.digium.com/pipermail/asterisk-users/attachments/20101124/664e0c5d/attachment.htm

On Wednesday 24 November 2010 11:07:40 Bruce B wrote:
> This is not to bash the Asterisk project or Digium. Don't respond if
you
> have a difference of opinion as I am not looking for personal opinions
> but rather JUST WONDERING THE TECHNICAL/TACTICAL CAUSE of not
> documenting thing that are really hidden from the community and one has
> to go through a much manual process to find out about.
It's not a tactical or even a conscious decision.  The documentation arose
at voip-info organically, from the days when there was only a single
committer to Asterisk.  There's never been much of a coordinated attempt
to replace that resource, mostly due to the large amount of labor that we
would need.  There are certainly efforts to document Asterisk and keep the
documentation up to date (see the Asterisk Documentation Project).
Anything that you would like to contribute in this regard would be welcome.

-- 
Tilghman Lesher
Digium, Inc. | Senior Software Developer
twitter: Corydon76 | IRC: Corydon76-dig (Freenode)
Check us out at: www.digium.com & www.asterisk.org