some doc fixes/improvements