tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bugzi...@apache.org
Subject DO NOT REPLY [Bug 18790] - ROOT Context Name is "Magic"
Date Sun, 20 Apr 2003 06:07:52 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=18790>.
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=18790

ROOT Context Name is "Magic"





------- Additional Comments From tony@absolutejava.com  2003-04-20 06:07 -------
Yes, you are correct when you say, "Experimenting during a fraction of the
amount of time it took you to write this would have brought an answer..."

But think of the hundreds or thousands of users having to do the *same* 
experiment to reach the *same* conclusion: that ROOT is "special".

That's why I took the time to write the original report. Two or three sentences 
of added explanation in the docs could clarify this point and save many users 
from wasting time "experimenting".

Really, I have to say this is a very sloppy attitude -- expecting users to 
experiment in order to determine correct behavior when it's so simple to add a 
single sentence to the docs. Why are you not interested in incremental 
improvements to the docs? The docs are just as important as the underlying 
code. Think of these small doc changes as being analogous to "bug fixes" to the 
documentation.

Actually, the issue is quite black and white. It has nothing to do with being 
a "doc lawyer". The documentation clearly states: "...you MUST define a Context 
with a context path equal to a zero-length string." This sentence is simply not 
true. It has nothing to do with being a "doc lawyer". The existing 
documentation is flat out wrong. There's nothing subtle about it.

I'm just trying to help. You (not you, personally) ask for bugs in the 
documentation, right? Well here it is.

---------------------------------------------------------------------
To unsubscribe, e-mail: tomcat-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: tomcat-dev-help@jakarta.apache.org


Mime
View raw message