Docs improvements

Some docs improvements solving some issues.
Added a text to explain better: d2e4f8c