Docs improvements

Some docs improvements solving some issues.
We use tabs in our code. In the docs there is a convention? You prefer space or tab?