please add javadoc to all public methods (especially of interfaces)