these methods are what users implement in their testing code, so i think they really should have phpdoc on expected return values and semantics.