On Friday 09 July 2004 09:15 am, Mike Curwen wrote:
> The point I was attempting to make is that there is nothing wrong with
> the docs,
Yes, I know. And the point that I am trying to make is that several readers
of the documentation disagree with you on this point. And that is, in my
opinion, sufficient reason to conclude that there _is_, or at least may be,
something "wrong" with the docs.
It's really pointless to argue that the docs are semantically correct. It
doesn't matter. What matters is whether or not they helped the readers.
That's all that matters. If they did then they may be semantically gibberish
and yet they are good. If they did not then they are wrong, regardless of
semantics.
As an aside. The place to fix this problem with the docs, in my opinion, is
in the error messages. If the error messages told the user exactly what
mistake it made then the problem with the docs would be irrelevant. So,
instead of "Cannot access XXX" it should say, "I found a subdirectory of
webapps of the correct name but it doesn't contain a WEB-INF directory so I
cannot proceed." Or, "I found a subdir and a WEB-INF dir and a web.xml there
but it doesn't have XXX in the YYY place." Then no one would care about the
semantics of the other documentation -- it would be redundantly obscure.
-- Michael
---------------------------------------------------------------------
To unsubscribe, e-mail: tomcat-user-unsubscribe@jakarta.apache.org
For additional commands, e-mail: tomcat-user-help@jakarta.apache.org