[richfaces-planning-issues] [JBoss JIRA] Commented: (RFPL-990) CSV: documentation review and promotion subtask

[Ilya Shaikovsky (JIRA)]

    [ https://issues.jboss.org/browse/RFPL-990?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12583577#comment-12583577 ] 

Ilya Shaikovsky commented on RFPL-990:
--------------------------------------

+Overview:

"RichFaces Client-Side Validation consists of the <rich:validator> and <rich:graphValidator> behaviors."
<rich:graphValidator> is not related to client validation anyhow. It's object validation and performed on the server side always. And it's not a behaviopr b.t.w. 

+7.1 rich:validator:

"7.1.4. Fall-backs" let's probably use "Ajax Fall-backs" ?

"JSF client-side validators" Note. At first not "JSF Client side vaildators" but "JSF validation tags", 
And the second - that Note I think placed in wrong section. Let's move it after that section:
"7.1.1. Basic usage
The <rich:validator> behavior is added as a child element to any input control. The value of the input control must reference a managed bean. The <rich:validator> behavior validates the content of the input control on the client-side based on registered server-side validators included in the managed bean."


+7.2 rich:graphValidator (I guess there is no separate task and that one should be used for review):

"The <rich:graphValidator> behavior is used to wrap a group of input components for overall validation with Hibernate Validators." That was fine for 3.3.3 but not true now. JSF 2.0 supports Bean/Hibernate validators addition of of the box. So it's not main goal for the component anymore.  I prefer to write something like:
"The <rich:graphValidator> tag used to wrap some set of inputs realted to the same object in order to perform complete object validation(including properties which is not bound to components)."

"7.2.1. Basic usage
The summary attribute is used for displaying messages about validation errors."
I belive most important and basic functionality is value attribute which should be bound to Object for validation.

"Example 7.5. <rich:graphValidator> example"
has no sence in JSF 2 world. As I mentioned in first comment for 7.2 it already works out of the box so it's not our feature.

"Example 7.6. Using the value attribute"
should become the only and most important in that section. That's what we still added to JSF 2 built-in behavior. I sent you my detailed description by email.

> CSV: documentation review and promotion subtask
> -----------------------------------------------
>
>                 Key: RFPL-990
>                 URL: https://issues.jboss.org/browse/RFPL-990
>             Project: RichFaces Planning
>          Issue Type: Task
>      Security Level: Public(Everyone can see) 
>          Components: doc
>    Affects Versions: 4.0.0.Milestone2
>            Reporter: Ilya Shaikovsky
>            Assignee: Sean Rogers
>             Fix For: 4.0.0.CR1
>
>   Original Estimate: 0 minutes
>  Remaining Estimate: 0 minutes
>


--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira