please add javadoc for those methods