SONARJAVA-9 Improve Javadocs