Re: [Asterisk-java-devel] Asteirsk-Java IAX

[Martin B. S. <ma...@mb...>]

Stefan Reuter wrote:
> Martin B. Smith wrote:
>> I'd specifically like to work on the documentation for helping users
>> figure out which parts of our code they might want to use. To that end,
>> I'm welcoming comments still on my feature matrix.
> 
> Thanks for your work. I've replied to your original posting.

Great -- I've updated it!

>> I'd also like to continue to work on the FAQ and add on to it. I'll be
>> continuing to answer -users questions, too.
> 
> That's great!
> Wolfgang offered to work on the JavaScript documentation and asked
> whether we can help him with proof reading. I already thought of Martin
> as a native speaker and our AJ documentatione expert :-)
> Could you help Wolfgang in this regard and setup a JavaScript docu page
> similar in the asterisk-java-iax maven site directory?

I'd be happy to help with that. I've saved his e-mail here and I'll plan
on helping with that as my time permits.

>> At the risk of volunteering
>> for some huge project, what would you think about a samples package? I
>> know we've talked about this before... but I think I have a clearer idea
>> for what we should do. I'm thinking small single-piece functionality.
>> Not that I have time for any of it -- LOL.
> 
> Huh. Yes that would indeed be a great thing. What kind of software could
> that be? Should it show all APIs in one application or several smaller
> pieces?

The best model I can think of for this is JUNG's examples
(http://jung.sourceforge.net/applet/index.html).  I'm thinking
single-functionality examples. I think when I blog and post some mammoth
program, people "don't see the forest for the trees" -- meaning they get
distracted by the details, but don't see the big picture: an example of
originate with tracking of success.

Perhaps we could even do them as applets, and post them on the site.
Obviously, some will require some extra Asterisk setup, but in theory,
we could document that in the comments or even (for some features) point
the applets at a live Asterisk like Digium's demo IAX extension.

> 
> =Stefan
> 



Martin