SONAR-4675 add some documentation