From d8f95e0432c52ea083cea3a0d3252fd12c0815e3 Mon Sep 17 00:00:00 2001 From: Kevin Longe <273747162+kvlonge@users.noreply.github.com> Date: Thu, 10 Sep 2026 09:50:06 +0100 Subject: [PATCH] docs: simplify rules benchmark headers --- benchmarks.mdx | 8 +++++--- concepts/rules.mdx | 2 +- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/benchmarks.mdx b/benchmarks.mdx index 44c1a2c..dd1e764 100644 --- a/benchmarks.mdx +++ b/benchmarks.mdx @@ -99,10 +99,9 @@ project contains: On this project, 20 custom Rules complete their first compile in just over 10 seconds. An unchanged compile completes in under six seconds. -Even with 100 custom Rules—500,002 Rule evaluations—an unchanged compile completes in just over -seven seconds. +Even with 100 custom Rules, an unchanged compile completes in just over seven seconds. -| Compile | 20 custom Rules
100,002 evaluations | 100 custom Rules
500,002 evaluations | +| Compile | 20 custom Rules | 100 custom Rules | |---|---:|---:| | First compile (no cache) | 10.83s | 12.19s | | Unchanged compile | 5.81s | 7.24s | @@ -111,6 +110,9 @@ seven seconds. Each measurement executes the complete `sqb compile` command. The edit scenario changes 50 of the 5,000 models before recompiling. +Because most Rules in this profile evaluate once per model, the 20- and 100-Rule configurations +perform roughly 100,000 and 500,000 Rule evaluations respectively. + Increasing the custom Rule pack from 20 to 100 multiplies the number of Rule evaluations by five, while the unchanged compile median increases from 5.81 to 7.24 seconds. diff --git a/concepts/rules.mdx b/concepts/rules.mdx index e8e2e92..b0a78e1 100644 --- a/concepts/rules.mdx +++ b/concepts/rules.mdx @@ -211,7 +211,7 @@ the inputs each Rule depends on so cached findings are reused only while those i In required CI, 20 custom Rules over a production-shaped 5,000-model project complete their first compile in just over 10 seconds and an unchanged compile in under six. A 100-Rule stress profile -reuses all 500,002 cached evaluations in just over seven seconds. +completes an unchanged compile in just over seven seconds. See [Benchmarks](/benchmarks#rules-performance) for the complete workload, methodology, and results, and [Execution and caching](/concepts/rules/execution-and-caching) for the Rules lifecycle.