[richfaces-issues] [JBoss JIRA] Commented: (RF-2086) Errors in components section

Errors in components section ---------------------------- Key: RF-2086 URL: http://jira.jboss.com/jira/browse/RF-2086 Project: RichFaces Issue Type: Bug Components: doc Affects Versions: 3.1.0 Reporter: Svetlana mukhina Assigned To: Vladimir Sukhov Fix For: 3.1.4, 3.2.0 1. < a4j:ajaxListener > Key attributes and ways of usage The <a4j:ajaxListener> component is the same one as "actionListener" or "ValueChangeListener", but for an Ajax container. "actionListener" -> <f: actionListener > "ValueChangeListener" -> <f: f:valueChangeListener> 2. < a4j:ajaxListener > "Key attributes and ways of usage Attribute "type" described in the following chapter. " following chapter - the link doesn't work; +better to make an attribute description here, it's the only one for the component . +highlight "type". revise the following description "Attribute "type" described in the following chapter. defines the fully", change it into "Attribute "type" described in the following chapter. It defines the fully..." "This class should implement org.ajax4jsf.framework.ajax.ajaxListener interface." not "should implement", but "implements" (though, check it). 3.< a4j:keepAlive > Key attributes and ways of usage highlight meaningful words ('managed-bean-scope' and etc.) and frame attributes names in quotes 'beanName'. 4. < a4j:actionparam > Key attributes and ways of usage highlight attributes frame in quotes : "converter", "assignTo", "name" and etc. "If it is set to "true", the value will be evaluated as a JavaScript code" (use present simple here and in other similar cases, not future ). 5.. < a4j:commandButton > in "Key attributes and ways of usage" highlight meaningful words. "see <a4j:support> chapter" (create a link). highlight meaningful word 'A4J.AJAX.Submit'. "Creating on a page" the section should contain only the simplest tag usage example, thus all explanation should be moved to "Key attributes and ways of usage." As "Key attributes and ways of usage" section should contain continuation of Creating on a page section. meaningful word "action1" highlight in blue without italic "someData" delete italic, as it's a meningfull word and not an attribute. 6. < a4j:form > "Creating on a page <a4j:form> <!--...Some content to be submitted.--> </a4j:form>" sentence "<!--...Some content to be submitted.-->" should be replaced with code. "Relevant resources links Here. you can see the example of <a4j:form> usage and sources for the given example." unnecessary point after here. 7. Everywhere in Guide check that link should be only on the required words not on "." or space. 8. There are links to demo-site for all components, but not each component has examples, in this case we need to correct the link text, providing some general sentence. E.g. "Here you can found some additional information for ... component usage."