Implement javadoc generation and publishing

[plaird]

trafficstars

This is three tasks:

• improve the Javadoc in our code base
• generate the javadoc out of the build
• publish on gh-pages

Figure out what to do about the test framework - do we include it in the main javadoc or separate.