DOC: docs to add detail on gotchas for true value testing