[misc] Improve javadoc