Docs improvements

Some docs improvements solving some issues.
I don't know =P I think we should use tabs too. What do you think?