Merge pull request #35 from apache/MDEP-753

[MDEP-753] add more JavaDoc