Docs improvements

Some docs improvements solving some issues.
> and so son.. 

. or ...