On Tue, Jun 16, 2009 at 1:20 PM, Jim Driscoll <Jim.Driscoll@sun.com> wrote:
The composite PDL currently has an exmaple component, which takes up a rather large amount of space, and, I feel, doesn't really give a lot of information for someone coming to the technology for the first time.

At the same time, important information like the specialness of the values "action", "actionListener", "validator", and
"valueChangeListener" are buried in the name attribute of the composite:attribute page.

I think we might be better served by removing the example (or else, using a much smaller and simpler example), and including information like the special names in that freed space.

What do you guys think?  Am I off base?

I've filed the following spec issue 572 to track this:
https://javaserverfaces-spec-public.dev.java.net/issues/show_bug.cgi?id=572

+1. Make it simpler. After all, we are trying to demonstrate just how simple the easy component creation is, and frankly this example doesn't convince me (though I do certainly appreciate what it is trying to show).

-Dan

--
Dan Allen
Senior Software Engineer, Red Hat | Author of Seam in Action

http://mojavelinux.com
http://mojavelinux.com/seaminaction
http://in.relation.to/Bloggers/Dan

NOTE: While I make a strong effort to keep up with my email on a daily
basis, personal or other work matters can sometimes keep me away
from my email. If you contact me, but don't hear back for more than a week,
it is very likely that I am excessively backlogged or the message was
caught in the spam filters.  Please don't hesitate to resend a message if
you feel that it did not reach my attention.