[richfaces-planning-issues] [JBoss JIRA] (RFPL-2978) Remove Reference Data from Component Reference

Brian Leathem (JIRA) jira-events at lists.jboss.org
Sun Dec 1 02:42:06 EST 2013


     [ https://issues.jboss.org/browse/RFPL-2978?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Brian Leathem updated RFPL-2978:
--------------------------------

    Description: 
See [Forum Reference].

----

I have noticed each of the components in Component Reference contains reference data:
 
 
{code}
3.5.2. Reference data
 
component-type: org.richfaces.CommandLink
component-class: org.richfaces.component.UICommandLink
component-family: javax.faces.Command
renderer-type: org.richfaces.CommandLinkRenderer
{code}
 
Similarly, VDL doc contains same information:
 
 {code}
Tag Information
Component type	org.richfaces.CommandLink
Tag Name	a4j:commandLink
Renderer Type	org.richfaces.CommandLinkRenderer
Handler Class	None
 {code}
 
 
The advantage of VDL doc is that it is automatically generated and so it doesn't need to be updated manually everytime something is changed.
 
On the other hand, those are also not information which are used regularly - they are intented for advanced users and use cases.
 
Thus I suggest to remove the Reference Data from Components Reference.

  was:
See [Forum Reference].

----

I have noticed each of the components in Component Reference contains referecen data:
 
 
{code}
3.5.2. Reference data
 
component-type: org.richfaces.CommandLink
component-class: org.richfaces.component.UICommandLink
component-family: javax.faces.Command
renderer-type: org.richfaces.CommandLinkRenderer
{code}
 
Similarly, VDL doc contains same information:
 
 {code}
Tag Information
Component type	org.richfaces.CommandLink
Tag Name	a4j:commandLink
Renderer Type	org.richfaces.CommandLinkRenderer
Handler Class	None
 {code}
 
 
The advantage of VDL doc is that it is automatically generated and so it doesn't need to be updated manually everytime something is changed.
 
On the other hand, those are also not information which are used regularly - they are intented for advanced users and use cases.
 
Thus I suggest to remove the Reference Data from Components Reference.


    
> Remove Reference Data from Component Reference
> ----------------------------------------------
>
>                 Key: RFPL-2978
>                 URL: https://issues.jboss.org/browse/RFPL-2978
>             Project: RichFaces Planning
>          Issue Type: Task
>      Security Level: Public(Everyone can see) 
>          Components: doc
>    Affects Versions: 5.0.0.Alpha1
>            Reporter: Lukáš Fryč
>             Fix For: 5.0.0.Alpha2
>
>   Original Estimate: 2 hours
>  Remaining Estimate: 2 hours
>
> See [Forum Reference].
> ----
> I have noticed each of the components in Component Reference contains reference data:
>  
>  
> {code}
> 3.5.2. Reference data
>  
> component-type: org.richfaces.CommandLink
> component-class: org.richfaces.component.UICommandLink
> component-family: javax.faces.Command
> renderer-type: org.richfaces.CommandLinkRenderer
> {code}
>  
> Similarly, VDL doc contains same information:
>  
>  {code}
> Tag Information
> Component type	org.richfaces.CommandLink
> Tag Name	a4j:commandLink
> Renderer Type	org.richfaces.CommandLinkRenderer
> Handler Class	None
>  {code}
>  
>  
> The advantage of VDL doc is that it is automatically generated and so it doesn't need to be updated manually everytime something is changed.
>  
> On the other hand, those are also not information which are used regularly - they are intented for advanced users and use cases.
>  
> Thus I suggest to remove the Reference Data from Components Reference.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira



More information about the richfaces-planning-issues mailing list