benchmarks.md

@@ -2,8 +2,20 @@
 
 This page contains information about benchmarks that are or were useful for solving issues. The issue that first motivated the creation of this page is #8885.
 
+## Benchmark tests
+
+Pytest has 2 modes of [calibration](https://pytest-benchmark.readthedocs.io/en/stable/calibration.html):
+
+* **automatic:** By default pytest-benchmark will try to run your function as many times needed to fit a 10 x `TIMER_RESOLUTION` period. 
+* **pedantic:** defaults to `rounds=1`, `warmup_rounds=0` and `iterations=1`.
+
 ## Tests table
 
+Configurations:
+
+* `warmup_rounds=0` for all tests.
+* `iterations=1` for all tests.
+
 | **module**       | **name**                     | **mean time (ms)** | **rounds** | **function**             |
 | ---------------- | ---------------------------- | -----------------: | ---------: | ------------------------ |
 | `test_resources` | `test_memory_intensive`      | 3843.1             | 5          | `monitored_benchmark`    |