Minor documentation rewrite

Some bits and bobs.