further clarify the docs for 'evaluate'