Docs: reference example test files in README and clarify benchmark example docstring

README.md

@@ -27,7 +27,7 @@ assert constant_number() == 2
 # alternative implementations still act like themselves
 assert unused_alternative_constant_number() == 3
 
-# TODO: mash in measure + benchmark + equality tests from examples
+See `examples/test_measure.py`, `examples/test_equivalence.py`, and `examples/test_benchmark.py` for measure, equivalence, and benchmark pytest patterns (the benchmark example uses the `pytest-benchmark` fixture).
 ```
 
 The library tries to avoid unpleasant surprises that may come from import orders or maintenance issues:

examples/test_benchmark.py

@@ -15,5 +15,5 @@ def alternative_implementation1():
 
 @reference_implementation.pytest_parametrize(only_default=False)
 def test_f(benchmark, implementation):
-    """Compare the output of the reference (with caching) and each alternative implementation."""
+    """Benchmark all implementations using the pytest-benchmark `benchmark` fixture."""
     assert benchmark(implementation) == 1