axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bugzi...@apache.org
Subject DO NOT REPLY [Bug 21592] - WSDL2Java doc. should start with description of what tool does
Date Tue, 15 Jul 2003 01:09:57 GMT
DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUG 
RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT
<http://nagoya.apache.org/bugzilla/show_bug.cgi?id=21592>.
ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED AND 
INSERTED IN THE BUG DATABASE.

http://nagoya.apache.org/bugzilla/show_bug.cgi?id=21592

WSDL2Java doc. should start with description of what tool does





------- Additional Comments From stevel@apache.org  2003-07-15 01:09 -------
1. by leaving bugs open they stay open, meaning they dont get ignored. It is
only when they get closed that they are forgotten. Dont worry. 

2. open source projects are the work of collaborative efforts; the dividing line
between users and developers is very blurred, and if you can get people to take
on the workload of fixing things they want, then everyone benefits.

3. in the absence of any formal team, the original developers of the docs & code
have often moved on, so there is nobody to take direct responsibility for the
work other than 'the dev team as whole', who often get too distracted by
functionality issues to address documentation faults. Even though axis docs do
need to be vastly improved :(

4. If you are going to the effort of submitting detailed errors on the docs, it
is not much extra work to actually provided corrected documentation. This should
rapidly be picked up and patched in (as unlike code patches, it rarely breaks
things), so you would get an immediate reward for your effort. And, coming to
the system without much background does give you insight into how things should
be documented better for beginners.

5. If you dont submit patches, the bug will stay open and will probably at some
indeterminate in the time in the future get corrected, but there is no way of
determining when it will be fixed. None of the axis bugreps have been open long
enough to have fifth birthday poems written to them (unlike say the java.sun.com
bugs), but they do get fixed in an uncontrolled manner. 

So yes, OSS projects do usually bounce back bugreps to users with 'a fix would
be good', because the users are the developers. This is bad -you have to do more
work yourself- and good: the developers are working to the users deadlines and
care about your problems. 

but if you dont want to submit patches, fine. The bugreps will accrue, and
probably get addressed eventually.

Mime
View raw message