some more documentation

Just added a bit more documentation in in various places.