Re: [Asterisk-java-devel] Asteirsk-Java IAX
Brought to you by:
srt
From: Martin B. S. <ma...@mb...> - 2009-03-10 21:51:17
|
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 |