Documentation improvements

I find the attached changes improve the usability of the documentation. Mostly a matter of look&feel, feel free to pick only some of the changes if you like.