Docs improvements

Some docs improvements solving some issues.
Oops. I'm crasy. This is too basic, and I did wrong :)