Docs improvements

Some docs improvements solving some issues.
I don't think so... if it's readable on page :)