I guess, I don't want to extend this thread to much and make other people bored to death
don't worry about that, dude. Your comments are valued very much! (most open source projects are always looking for more feedback :D)
<joke>you should take a look at the traffic on the development list...boy those threads sometimes bore you to death ;)</joke>
but my take on documentation is a little different. You can NOT expect newcomers to start writing a lot of documentation without knowing well a fairly large framework like Avalon, this approach will add even more to the existing confusion around this project. Those that want to research code themselves will be OK for their projects and probably would not be able to put even more time into making it easier for others.
yep. Its the same problem for everyone. I wouldn't know for sure, but I'll bet you a beer that Aaron is working on the wiki docs late at night. Which, while nice, is also not something we can actually expect from anyone.
There is just, unfortunately, very little incentive for businesses to invest time and money into avalon. And when someone writes docs inside the business, there's too little incentive to contribute back.
You see, when you work for your employer, you usually start with at least some form of design document that can be, consequently, converted into documentation. Nature of most open-source projects do not support this development model since majority of participants come from a "hacker mentality" crowd.
that's a bit different here, too. I don't think any of the avalon devs are from the "hacker mentality" crowd. Most people over here (I'm an exception to the rule atm, in fact ;)) make their living working on and with avalon software.
For apache as a whole (at least the java side of it), that's true for a large part of any project's committers.
Well, Aaron is an exception to this rule. He seems to be dedicated to making things better (hmm, I still haven't heard from him regarding putting pp doc on the Avalon's site).
you can just upload it yourself to the wiki if you want. It won't take you more than three minutes. The reason I didn't was because I figured you might want to have the link back to your company site :-D
Thanks to all other participants in this thread for good suggestions. I will try to move on with some improvements and also create smaller presentations dedicated to different Avalon products. They should include solid examples on top of architectural details (...with Aaron's help).
that'd be awesome :D
-- cheers,
- Leo Simons
----------------------------------------------------------------------- Weblog -- http://leosimons.com/ IoC Component Glue -- http://jicarilla.org/ Articles & Opinions -- http://articles.leosimons.com/ ----------------------------------------------------------------------- "We started off trying to set up a small anarchist community, but people wouldn't obey the rules." -- Alan Bennett
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
