[TASK] documentation updated (typos, styles and formatting corrected)
[TASK] code clean up to comply with SonarSource CGL