Some improvements to the docs

Hi.

I hope you'll find the contribution interesting