Docs improvements

Some docs improvements solving many issues.