[asterisk-users] Manager Interface API's

[Douglas Garstang]

> -----Original Message-----
> From: Brian Capouch [mailto:brianc at palaver.net]
> Sent: Tuesday, August 15, 2006 11:15 AM
> To: Asterisk Users Mailing List - Non-Commercial Discussion
> Subject: Re: [asterisk-users] Manager Interface API's
> 
> 
> Douglas Garstang wrote:
> > Can anyone recommend the best Manager Interface API, 
> putting language 
> > preferences aside?
> >  
> > The python and perl ones have bupkiss documentation. I 
> can't understand 
> > why anyone would even write an api and make it publically available 
> > without documenting it.
> >  
> 
> Have you taken your "be nice on the lists" pill today?
> 
> The most likely explanation is that people have written these 
> interfaces 
> primarily for their own use, and when they decided to share 
> with others, 
> only had/made time to minimally document them.
> 
> Do you understand that?  You've got me doubting you can't understand 
> such things, so I wonder why you *say* you don't understand.
> 
> Unless you enjoy being a troll.

I must be about the only person who thinks that an API without documentation is completely useless. As I said in another post, this isn't some GUI where you can poke around with it and work out how it works by experimentation. Documentation of the API is essential. 

Why did they have time to write it, but suddenly run out of time when it came time to document? It's human nature to start something and lose interest. Given that documentation always happens at the end, it's what usually suffers.