more doc fixes and minor method cleanup