add javadocs to public methods