lots of doc fixes