layout improvements
iterating on the user manual
recreating javadocs