struts-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Michael Jouravlev <>
Subject Re: new website look
Date Tue, 01 Nov 2005 18:50:13 GMT


This is hardly readable:

=== cut here ==
base Render an HTML &lt;base&gt; Element Renders an HTML &lt;base&gt;
element with an href attribute pointing to the absolute location of
the enclosing JSP page
=== cut here ==

* Escaped tag angle brackets.
* This particular snippet looks like it was copied right from
Javadocs, the first sentence should obviously be removed.


On content note, the taglib docs always made me re-reading each
sentence twice or more trying to understand what it was about. For
example, here is submit element

This one is perfectly clear: "value - The value of the button label."
While this one left me scratching my head couple of years ago:
"property - Name of the request parameter that will be included with
this submission, set to the specified value." Why it could not be
simply "property - the value of 'name' attribute".

Still not good, both of these descriptions use "value", which happens
to be a meta-word. Such words as "value", "name", "parameter",
"forward", "redirect" should be used very carefully if there is a risk
to confuse an attribute name (here you have it) or a particular
request method with a meta-word.

So, I would change the first one to a simple:
"value - the 'value' of the button."
  or maybe would add some clarification for HTML-challenged people:
"value - the 'value' of the button (a button label, visible to a user)."

And the second one to:
"property - the 'name' of the button."
  or to a more descriptive for HTTP-challenged:
"property - the 'name' of the button (a request key)"


It is yet another question why the attribute name is "property" and
not just a "name", but this question was possibly raised too many
times on this list. The problem with this name is that a person
knowlegeable of HTML would look for "name", not a "property".


"property" and "value", being the most important attributes of
"submit" element, should be emphasized with bold.


There should be examples for the most common usages along with generated HTML.


Recalling an old discussion of user-defined attributes in the tags,
Struts should have it instead of redefining all standard HTML
attributes and then explaining their meaning. Just define ones that
are parsed and used by Struts, and leave all other attributes to app
developer's discretion, just pass them through to HTML. We should
trust developers who use the framework.


To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message