CDAP-489: improve java-doc