SONAR-3755 improve documentation