more doc fixes and updates