please add proper javadoc rather than simple inline comments