On Tue, 2005-06-28 at 13:48 -0700, Eric Johnson wrote: > I'm following the Apache Axis 2.0 project with some interest. At this > time, though, I find I cannot recommend it for use at my company for at > least the following reasons: > > * Need better documentation on how to use - something like the > Apache Axis 1.X tutorials would help. The current docs seem to > trail off at some critical points, and are very developer, rather > than user focused. (I note that Glen Daniel's recent presentation > had some useful content.)
Interesting ... I've heard the opposite from someone else :-) (not about Glen's prez but about the docs!). > * Missing documentation on how to migrate from Axis 1.X > * No demostration of Axis 1.X interoperability +1 to putting these. > * AXIOM seems unproven. Showing how you can use AXIOM separate from > its use in Axis would help prove its value. Why? AXIOM has significant value inside Axis2 .. just think of implementing a pass-thru scenario. Maybe we need to illustrate its value to Axis2 itself more so that people don't ask "Why YAXOM?". > Also, it strikes me > that some genuine benchmarks comparing the raw performance of > Xerces DOM with AXIOM might be revealing. This has been done; pls check the list archives. > I'm not meaning to cause argument. Rather, I'm looking to trigger a > discussion of what sorts of documentation, if any, should be included as > part of the "features" list, 'cause I know that more documentation will > help some people out. > > I'll even contribute if I can, although I don't know how likely that is. I think if you could write a table of contents for what docs you think you'd find useful and what you'd like to see in them that would be a good start. (Please go down to at least 3 levels in the TOC.) Then you can even start writing some of the stuff ;-). In any case, +1 for getting the docs lined up right before we go to 1.0. Sanjiva.
