updated docs for evaluate()