update mutator docs.