thomhurst · thomhurst · Jun 1, 2026 · Jun 1, 2026 · Jun 1, 2026 · Jun 1, 2026
diff --git a/.github/scripts/process-benchmarks.js b/.github/scripts/process-benchmarks.js
@@ -178,6 +178,8 @@ sidebar_position: ${Object.keys(categories.runtime).indexOf(testClass) + 2}
 
 # ${testClass} Benchmark
 
+> ${RUNTIME_DESCRIPTIONS[testClass] || `Performance benchmark for ${testClass}.`}
+
 :::info Last Updated
 This benchmark was automatically generated on **${timestamp}** from the latest CI run.
 
@@ -275,6 +277,8 @@ sidebar_position: ${Object.keys(categories.runtime).length + 2}
 
 # Build Performance Benchmark
 
+> Compilation time from a clean build across frameworks — how long it takes to build an identical test project.
+
 :::info Last Updated
 This benchmark was automatically generated on **${timestamp}** from the latest CI run.
 

diff --git a/.github/scripts/process-mock-benchmarks.js b/.github/scripts/process-mock-benchmarks.js
@@ -305,6 +305,8 @@ sidebar_position: ${index + 2}
 
 # ${category} Benchmark
 
+> ${description} — comparing **TUnit.Mocks** (source-generated) against runtime proxy-based mocking libraries.
+
 :::info Last Updated
 This benchmark was automatically generated on **${timestamp}** from the latest CI run.
 

diff --git a/docs/docs/benchmarks/AsyncTests.md b/docs/docs/benchmarks/AsyncTests.md
@@ -6,6 +6,8 @@ sidebar_position: 2
 
 # AsyncTests Benchmark
 
+> Realistic async/await patterns with I/O simulation
+
 :::info Last Updated
 This benchmark was automatically generated on **2026-05-31** from the latest CI run.
 

diff --git a/docs/docs/benchmarks/BuildTime.md b/docs/docs/benchmarks/BuildTime.md
@@ -6,6 +6,8 @@ sidebar_position: 8
 
 # Build Performance Benchmark
 
+> Compilation time from a clean build across frameworks — how long it takes to build an identical test project.
+
 :::info Last Updated
 This benchmark was automatically generated on **2026-05-31** from the latest CI run.
 

diff --git a/docs/docs/benchmarks/DataDrivenTests.md b/docs/docs/benchmarks/DataDrivenTests.md
@@ -6,6 +6,8 @@ sidebar_position: 3
 
 # DataDrivenTests Benchmark
 
+> Parameterized tests with multiple data sources
+
 :::info Last Updated
 This benchmark was automatically generated on **2026-05-31** from the latest CI run.
 

diff --git a/docs/docs/benchmarks/MassiveParallelTests.md b/docs/docs/benchmarks/MassiveParallelTests.md
@@ -6,6 +6,8 @@ sidebar_position: 4
 
 # MassiveParallelTests Benchmark
 
+> Parallel execution stress tests
+
 :::info Last Updated
 This benchmark was automatically generated on **2026-05-31** from the latest CI run.
 

diff --git a/docs/docs/benchmarks/MatrixTests.md b/docs/docs/benchmarks/MatrixTests.md
@@ -6,6 +6,8 @@ sidebar_position: 5
 
 # MatrixTests Benchmark
 
+> Combinatorial test generation and execution
+
 :::info Last Updated
 This benchmark was automatically generated on **2026-05-31** from the latest CI run.
 

diff --git a/docs/docs/benchmarks/ScaleTests.md b/docs/docs/benchmarks/ScaleTests.md
@@ -6,6 +6,8 @@ sidebar_position: 6
 
 # ScaleTests Benchmark
 
+> Large test suites (150+ tests) measuring scalability
+
 :::info Last Updated
 This benchmark was automatically generated on **2026-05-31** from the latest CI run.
 

diff --git a/docs/docs/benchmarks/SetupTeardownTests.md b/docs/docs/benchmarks/SetupTeardownTests.md
@@ -6,6 +6,8 @@ sidebar_position: 7
 
 # SetupTeardownTests Benchmark
 
+> Expensive test fixtures with setup/teardown overhead
+
 :::info Last Updated
 This benchmark was automatically generated on **2026-05-31** from the latest CI run.
 

diff --git a/docs/docs/benchmarks/mocks/Callback.md b/docs/docs/benchmarks/mocks/Callback.md
@@ -6,6 +6,8 @@ sidebar_position: 2
 
 # Callback Benchmark
 
+> Callback registration and execution — comparing **TUnit.Mocks** (source-generated) against runtime proxy-based mocking libraries.
+
 :::info Last Updated
 This benchmark was automatically generated on **2026-06-01** from the latest CI run.
 

diff --git a/docs/docs/benchmarks/mocks/CombinedWorkflow.md b/docs/docs/benchmarks/mocks/CombinedWorkflow.md
@@ -6,6 +6,8 @@ sidebar_position: 3
 
 # CombinedWorkflow Benchmark
 
+> Full workflow: create → setup → invoke → verify — comparing **TUnit.Mocks** (source-generated) against runtime proxy-based mocking libraries.
+
 :::info Last Updated
 This benchmark was automatically generated on **2026-06-01** from the latest CI run.
 

diff --git a/docs/docs/benchmarks/mocks/Invocation.md b/docs/docs/benchmarks/mocks/Invocation.md
@@ -6,6 +6,8 @@ sidebar_position: 4
 
 # Invocation Benchmark
 
+> Calling methods on mock objects — comparing **TUnit.Mocks** (source-generated) against runtime proxy-based mocking libraries.
+
 :::info Last Updated
 This benchmark was automatically generated on **2026-06-01** from the latest CI run.
 

diff --git a/docs/docs/benchmarks/mocks/MockCreation.md b/docs/docs/benchmarks/mocks/MockCreation.md
@@ -6,6 +6,8 @@ sidebar_position: 5
 
 # MockCreation Benchmark
 
+> Mock instance creation performance — comparing **TUnit.Mocks** (source-generated) against runtime proxy-based mocking libraries.
+
 :::info Last Updated
 This benchmark was automatically generated on **2026-06-01** from the latest CI run.
 

diff --git a/docs/docs/benchmarks/mocks/Setup.md b/docs/docs/benchmarks/mocks/Setup.md
@@ -6,6 +6,8 @@ sidebar_position: 6
 
 # Setup Benchmark
 
+> Mock behavior configuration (returns, matchers) — comparing **TUnit.Mocks** (source-generated) against runtime proxy-based mocking libraries.
+
 :::info Last Updated
 This benchmark was automatically generated on **2026-06-01** from the latest CI run.
 

diff --git a/docs/docs/benchmarks/mocks/Verification.md b/docs/docs/benchmarks/mocks/Verification.md
@@ -6,6 +6,8 @@ sidebar_position: 7
 
 # Verification Benchmark
 
+> Verifying mock method calls — comparing **TUnit.Mocks** (source-generated) against runtime proxy-based mocking libraries.
+
 :::info Last Updated
 This benchmark was automatically generated on **2026-06-01** from the latest CI run.
 

diff --git a/docs/sidebars.ts b/docs/sidebars.ts
@@ -202,6 +202,17 @@ const sidebars: SidebarsConfig = {
         'extending/libraries',
       ],
     },
+    {
+      type: 'category',
+      label: 'Benchmarks',
+      collapsed: true,
+      items: [
+        {
+          type: 'autogenerated',
+          dirName: 'benchmarks',
+        },
+      ],
+    },
     {
       type: 'category',
       label: 'Comparing & Migrating',
@@ -236,17 +247,6 @@ const sidebars: SidebarsConfig = {
       collapsed: true,
       items: [
         'guides/philosophy',
-        {
-          type: 'category',
-          label: 'Benchmarks',
-          collapsed: true,
-          items: [
-            {
-              type: 'autogenerated',
-              dirName: 'benchmarks',
-            },
-          ],
-        },
       ],
     },
   ],