added a few more comments, add javadoc because we can