- """Decorate unittests with this to pay attention to the perf of the
- testcode and flag perf regressions. e.g.
+ """This decorator is meant to apply to classes that subclass from
+ :class:`unittest.TestCase` and, when applied, has the affect of
+ decorating each method that matches the `prefix` given with the
+ :meth:`check_method_for_perf_regressions` wrapper (see above).
+ This wrapper causes us to measure perf and fail tests that regress
+ perf dramatically.
+
+ Args:
+ prefix: the prefix of method names to check for regressions
+
+ See also :meth:`check_method_for_perf_regressions` to check only
+ a single method.
+
+ Example usage. By decorating the class, all methods with names
+ that begin with `test_` will be perf monitored::