improve documentation for evaluate