improved comments
more comments
improved javadocs
more javadoc
more javadoc
more and more javadocs
making sure everything is up to date