Add javadoc and reconfigured middleman to render them correctly

Signed-off-by: Kris Kelly <kkelly@pivotallabs.com>