Expand some of the documentation

Just some documentation elaboration. Hopefully you find it OK to merge :)