[doc] javadoc improvements