SONAR-3755 add some javadoc