closes #349 - updated docs for evaluate()