Docs improvements

Some docs improvements solving some issues.
you are using tabs or space? indentation here is different from others