some doc fixes and clen ups