Better benchmark formatting

Author: ejsmith

.github/scripts/Update-BenchmarkDocs.ps1

@@ -59,6 +59,41 @@ Write-Host "Parsing benchmark results..." -ForegroundColor Cyan
 $csv = Import-Csv $ResultsFile
 $currentDate = Get-Date -Format 'yyyy-MM-dd'
 
+# Group benchmarks by operation type (Command, Query, Event/Publish, QueryWithDependencies)
+$groups = @{
+    'Command' = @()
+    'Query' = @()
+    'Publish' = @()
+    'QueryWithDependencies' = @()
+}
+
+# Define the order of implementations
+$implOrder = @('Direct', 'Foundatio', 'MediatR', 'MassTransit')
+
+foreach ($row in $csv) {
+    $method = $row.Method
+    if ($method -match 'QueryWithDependencies') {
+        $groups['QueryWithDependencies'] += $row
+    } elseif ($method -match 'Command') {
+        $groups['Command'] += $row
+    } elseif ($method -match 'Query') {
+        $groups['Query'] += $row
+    } elseif ($method -match 'Publish|Event') {
+        $groups['Publish'] += $row
+    }
+}
+
+# Sort each group by implementation order
+foreach ($key in $groups.Keys) {
+    $groups[$key] = $groups[$key] | Sort-Object {
+        $method = $_.Method
+        for ($i = 0; $i -lt $implOrder.Count; $i++) {
+            if ($method -match "^$($implOrder[$i])_") { return $i }
+        }
+        return 999
+    }
+}
+
 # Build the markdown content
 $markdown = @"
 # Performance
@@ -68,13 +103,53 @@ Foundatio Mediator achieves near-direct call performance through C# interceptors
 ## Benchmark Results
 
 > 📊 **Last Updated:** $currentDate
-> 🔧 **Generated automatically by [GitHub Actions](https://github.com/FoundatioFx/Foundatio.Mediator/actions/workflows/benchmarks.yml)**
+
+### Commands
 
 | Method | Mean | Allocated |
 |:-------|-----:|----------:|
 "@
 
-foreach ($row in $csv) {
+foreach ($row in $groups['Command']) {
+    $markdown += "`n| $($row.Method) | $($row.Mean) | $($row.Allocated) |"
+}
+
+$markdown += @"
+
+
+### Queries
+
+| Method | Mean | Allocated |
+|:-------|-----:|----------:|
+"@
+
+foreach ($row in $groups['Query']) {
+    $markdown += "`n| $($row.Method) | $($row.Mean) | $($row.Allocated) |"
+}
+
+$markdown += @"
+
+
+### Events (Publish)
+
+| Method | Mean | Allocated |
+|:-------|-----:|----------:|
+"@
+
+foreach ($row in $groups['Publish']) {
+    $markdown += "`n| $($row.Method) | $($row.Mean) | $($row.Allocated) |"
+}
+
+$markdown += @"
+
+
+### Queries with Dependencies
+
+| Method | Mean | Allocated |
+|:-------|-----:|----------:|
+"@
+
+foreach ($row in $groups['QueryWithDependencies']) {
     $markdown += "`n| $($row.Method) | $($row.Mean) | $($row.Allocated) |"
 }
 

docs/guide/performance.md

@@ -7,21 +7,38 @@ Foundatio Mediator achieves near-direct call performance through C# interceptors
 > 📊 **Last Updated:** 2025-12-22
 > 🔧 **Generated automatically by [GitHub Actions](https://github.com/FoundatioFx/Foundatio.Mediator/actions/workflows/benchmarks.yml)**
 
+### Commands
+
 | Method | Mean | Allocated |
 |:-------|-----:|----------:|
 | Direct_Command | 7.143 ns | 0 B |
-| Direct_Query | 30.135 ns | 192 B |
-| Direct_Event | 5.898 ns | 0 B |
-| Direct_QueryWithDependencies | 34.721 ns | 264 B |
 | Foundatio_Command | 64.364 ns | 200 B |
 | MediatR_Command | 38.909 ns | 128 B |
 | MassTransit_Command | 1,249.631 ns | 4168 B |
+
+### Queries
+
+| Method | Mean | Allocated |
+|:-------|-----:|----------:|
+| Direct_Query | 30.135 ns | 192 B |
 | Foundatio_Query | 95.543 ns | 464 B |
 | MediatR_Query | 63.362 ns | 320 B |
 | MassTransit_Query | 5,583.887 ns | 12472 B |
+
+### Events (Publish)
+
+| Method | Mean | Allocated |
+|:-------|-----:|----------:|
+| Direct_Event | 5.898 ns | 0 B |
 | Foundatio_Publish | 144.341 ns | 648 B |
 | MediatR_Publish | 49.039 ns | 288 B |
 | MassTransit_Publish | 1,394.933 ns | 4320 B |
+
+### Queries with Dependencies
+
+| Method | Mean | Allocated |
+|:-------|-----:|----------:|
+| Direct_QueryWithDependencies | 34.721 ns | 264 B |
 | Foundatio_QueryWithDependencies | 105.046 ns | 536 B |
 | MediatR_QueryWithDependencies | 67.966 ns | 392 B |
 | MassTransit_QueryWithDependencies | 5,642.623 ns | 12544 B |
@@ -31,4 +48,4 @@ Foundatio Mediator achieves near-direct call performance through C# interceptors
 ```bash
 cd benchmarks/Foundatio.Mediator.Benchmarks
 dotnet run -c Release
-```
+```