document the result behaviour