The Forge API JavaDocs should be included in the Forge Distribution.
Publish JavaDoc to our Forge Website
We can also add PDF of wiki as well. something like JBoss-Forge-UserGuide-<version>.pdf or something similar. User can read and learn from the UserGuide. Make sure this must be updated and added in each release.
We've thought about the idea of a PDF user-guide, but we have opted for a centralized online documentation that is kept up to date via source control. See https://github.com/forge/website - currently hosted at forge.github.com, but we are still working on it.
We should generate another distribution (make another assembly execution) with the sources + javadocs only, so the forge-distribution-bin.zip doesn't increase in size.
If it increases the size we need to give a separate zip file for javadoc. src+jdoc is also a good option.
I think the following modules should be present on the javadoc. The other ones are purely implementation specific and their Javadoc is not useful for new plugin developers
Merged. Forge-javadoc.jar now contains the complete javadoc. We should publish to our website (or docs.jboss.org) soon.