Docs improvements

Some docs improvements solving some issues.
ok then :)