adding comments/javadocs