Improve interface documentation

Make sure that each method is well described by the Javadoc comments