You can use OmniFaces Vdldoc to generate documentation from your <cc:interface>
tags (or the documentation in taglib.xml
files).
Say your composite components reside in the /META-INF/resources/myLib
folder. You would then need a myLib.taglib.xml
-file in the META-INF
folder like this:
<facelet-taglib>
<description>Your description</description>
<namespace>http://example.com/myLib</namespace>
<short-name>my</short-name>
<composite-library-name>myLib</composite-library-name>
</facelet-taglib>
(For a more complete example, have a look at this question)
You can now use Vdldoc to generate your documentation:
java -jar vdldoc-2.1.jar myLib.taglib.xml
Update:
If your project uses maven there is now vdldoc-maven-plugin to easily integrate it into your build. Basically just add it to the <reporting>
-section of your pom.xml
:
<reporting>
<plugins>
<plugin>
<groupId>com.github.matinh.vdldoc</groupId>
<artifactId>vdldoc-maven-plugin</artifactId>
<version>2.0</version>
</plugin>
</plugins>
</reporting>
And run mvn site
to generate the documentation. See the plugin's homepage for more details.