I have noticed each of the components in Component Reference contains referecen data:
Similarly, VDL doc contains same information:
Tag Information Component type org.richfaces.CommandLink Tag Name a4j:commandLink Renderer Type org.richfaces.CommandLinkRenderer Handler Class None
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.
Yes, either remove it, or pull it in dynamically from the vdl doc.
Once 5.0.0.Alpha2 is underway, I'd like to hash out a re-stucture for the docs as we did for the build. Starting with user stories so we can all agree what we are trying to get out of the docs.