tomcat-users mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ken Martin <k...@digitalcyclone.com>
Subject Re: Newbie resources
Date Wed, 27 Feb 2002 21:15:51 GMT
On Wednesday, February 27, 2002, at 12:57 PM, Sriram Narayanan wrote:

> 1. Read the documentation. There's really a whole lot of 
> information given...

I do read the docs, but (not meaning to step on toes here) their 
not always clear to those who may not know the terminology.

For example... I'm just messing with taglibs right now... the 
"Tag Documentation" section of the docs for the UtilityTags Tag 
Library have a very brief description of the tag and attributes, 
but not one example. Yes, each little table has the raw data 
necessary, but simply showing...

<prefix:if predicate="<%= theTest %>">
	do this if true
</prefix:if>

...would communicate much more... and more effectively.

Another example, from the taglibs tutorial... under the "Hello 
World Tag Handler", the word "package" is refered to in the text 
and code sample, but I can see no description of what "package" 
is and what I should put there when creating my own taglib.

Or using the http://jakarta.apache... url as an example in 
places where it should point to the user's files; confusing 
because in some cases it must be the jakarta url (like in the 
DOCTYPE) and in some cases not. A better example url for cases 
when it's a client file would be something like 
http://location/of/your/file or something.

I'm really not trying to complain, I just want to show maybe a 
different perspective on the supplied docs, and why I was 
looking for a newbie slant on the information. Just like it's 
hard for me to remember what it's like not to know HTML 
structure inside and out, it may be hard for those making the 
docs to realize what someone coming in with a Tomcat tabla rasa.

With best intentions and a desire to learn more,

Ken Martin


--
To unsubscribe:   <mailto:tomcat-user-unsubscribe@jakarta.apache.org>
For additional commands: <mailto:tomcat-user-help@jakarta.apache.org>
Troubles with the list: <mailto:tomcat-user-owner@jakarta.apache.org>


Mime
View raw message