add javadocs to the interfaces