add javadocs to said method