doc fixes

I had a good look at the doc, noticed this could be improved.