Doc fixes following code review.
Always use the same writting.
small rewrite.