docs: link performance issues to benchmark harnesses

Co-authored-by: codegirl007 <s.raide@gmail.com>
2026-08-09 08:29:30 +00:00
parent 5e4758ce16
commit 95723af6a5
7 changed files with 106 additions and 11 deletions
@@ -55,6 +55,18 @@ Environment:
 - Optimized with `-debug -o:speed`
 - Linux x86-64

+## Reproduction harness
+
+Run the committed CPU harness on the baseline commit and again after applying
+the suggested fix:
+
+```bash
+make perf-draw PERF_ODIN_FLAGS="-debug -o:speed"
+```
+
+Keep `PERF_DRAW_ITERATIONS`, `PERF_DRAW_WARMUP`, and `PERF_DRAW_TRIALS`
+unchanged between commits. Compare `median_ns_per_draw`.
+
 ## Suggested fix

 Compute clip scaling once and construct corners from the unique coordinates: