rough draft of javadoc for the interfaces created in the last commit