feat: add benchmarks to api-reference on version deploy

Agent-Logs-Url: https://github.com/petesramek/polyline-algorithm-csharp/sessions/00d2cb8d-24e6-447f-9432-1196121e727c

Co-authored-by: petesramek <2333452+petesramek@users.noreply.github.com>

Author: Copilot

.github/workflows/publish-documentation.yml

@@ -96,6 +96,32 @@ jobs:
         run: |
           cp -r api-reference/guide api-reference/${{ env.friendly-version }}/guide
 
+      - name: 'Run benchmarks for v${{ env.friendly-version }}'
+        shell: bash
+        env:
+          benchmarks-artifacts: /tmp/benchmarks
+        run: |
+          dotnet run \
+            --project benchmarks/PolylineAlgorithm.Benchmarks/PolylineAlgorithm.Benchmarks.csproj \
+            --configuration Release \
+            --framework ${{ vars.DEFAULT_BUILD_FRAMEWORK || 'net10.0' }} \
+            -- --filter ${{ vars.BENCHMARKDOTNET_FILTER || '*' }} \
+               --exporters GitHub \
+               --memory \
+               --iterationTime 100 \
+               --join \
+               --artifacts ${{ env.benchmarks-artifacts }}/
+
+      - name: 'Inject benchmark results into guide for v${{ env.friendly-version }}'
+        shell: bash
+        env:
+          benchmarks-artifacts: /tmp/benchmarks
+        run: |
+          find ${{ env.benchmarks-artifacts }} -name "*-report-github.md" | sort | xargs cat > /tmp/benchmark_results.md
+          awk '/{benchmarks_section}/{while((getline line < "/tmp/benchmark_results.md") > 0) print line; close("/tmp/benchmark_results.md"); next} {print}' \
+            "api-reference/${{ env.friendly-version }}/guide/benchmarks.md" > /tmp/benchmarks.md
+          mv /tmp/benchmarks.md "api-reference/${{ env.friendly-version }}/guide/benchmarks.md"
+
       - name: 'Discover all versions'
         id: discover-versions
         shell: bash

api-reference/guide/benchmarks.md

@@ -0,0 +1,11 @@
+---
+title: Benchmarks
+---
+# Benchmarks
+
+Performance benchmarks for **PolylineAlgorithm for .NET** measured using [BenchmarkDotNet](https://benchmarkdotnet.org/).
+
+> [!NOTE]
+> Benchmarks are generated automatically during the release process. Results may vary depending on hardware and runtime version.
+
+{benchmarks_section}

api-reference/guide/toc.yml

@@ -8,3 +8,5 @@
   href: sample.md
 - name: FAQ
   href: faq.md
+- name: Benchmarks
+  href: benchmarks.md