[CON-73] enhance javadoc