One of the big successes of Tapestry 4 was the component reference, including examples.
Generating the component reference directly from the JavaDoc is a step in the right direction, but the complete solution needs the result to be easily navigated (a single page per class) and include examples.
I believe the examples can be packaged as an XML file with the Java class, accessible to the JavaDoc tool and integrated into the documentation.
|Field||Original Value||New Value|
|Assignee||Howard M. Lewis Ship [ hlship ]|
|Status||Open [ 1 ]||In Progress [ 3 ]|
|Status||In Progress [ 3 ]||Closed [ 6 ]|
|Resolution||Fixed [ 1 ]|
|Fix Version/s||5.0.10 [ 12312936 ]|
|Workflow||jira [ 12421858 ]||Default workflow, editable Closed status [ 12568334 ]|
|Workflow||Default workflow, editable Closed status [ 12568334 ]||jira [ 12590063 ]|