docs: Integrate charts demonstrating performance improvement in release post

Author: ntucker

website/blog/.cursor/rules/blog-posts.mdc

@@ -104,6 +104,36 @@ Note: Some imports (like `PkgTabs`) may appear after truncate if only used in Mi
 
 **Embedded demos:** Use `<StackBlitz app="app-name" file="path/to/file.tsx" />`
 
+## Performance Improvements
+
+When documenting performance gains:
+
+1. **Lead with narrative context** - Briefly explain *what* was optimized (caching, code paths, algorithms)
+2. **Quantify with multipliers** - Use concrete metrics like "2x" or "16x improvement"
+3. **Link evidence** - Reference the PR implementing the optimization and relevant docs
+4. **Visualize with mermaid chart** - Use `xychart-beta` bar chart comparing operations:
+
+```mermaid
+xychart-beta
+    title "Performance vs vX.Y"
+    x-axis ["operation1", "operation2", "operation3"]
+    y-axis "Percentage gain" 0 --> MAX_VALUE
+    bar [new_values]
+    bar [baseline_100s]
+```
+
+5. **Include benchmark links** - End with centered links to live benchmarks and source:
+
+```md
+<center>
+
+[Benchmarks over time](https://reactive.github.io/data-client/dev/bench/) | [View benchmark](https://github.com/reactive/data-client/tree/master/examples/benchmark)
+
+</center>
+```
+
+Keep the baseline bar at 100 for each operation to show relative improvement clearly.
+
 ## Conventions
 
 - **Each change must include:** a link to the PR (or commit if no PR) and relevant doc links

website/blog/2024-07-13-v0.14-release-announcement.md

@@ -207,6 +207,21 @@ Internal schema interface changes provide a **10% normalization performance boos
 
 Using `Map` instead of plain objects for entity storage provides up to **32% faster lookups** for large datasets. [#3390](https://github.com/reactive/data-client/pull/3390)
 
+```mermaid
+xychart-beta
+    title "Performance vs v0.13"
+    x-axis ["normalize", "denormalize (large)", "denormalize (small)"]
+    y-axis "Percentage gain" 0 --> 140
+    bar [110, 132, 115]
+    bar [100, 100, 100]
+```
+
+<center>
+
+[Benchmarks over time](https://reactive.github.io/data-client/dev/bench/) | [View benchmark](https://github.com/reactive/data-client/tree/master/examples/benchmark)
+
+</center>
+
 ## Schema/Data Modeling
 
 Schema APIs reduce boilerplate for common patterns while enabling more advanced use cases. Client-side joins now work across arbitrary entities (not just nested relationships), dynamic invalidation handles server-only deletion logic, and sensible defaults like `Entity.pk()` using `id` eliminate repetitive code.

website/blog/2025-01-XX-v0.15-vue-support-collection-remove.md

@@ -19,7 +19,7 @@ import Link from '@docusaurus/Link';
 - [mockInitialState()](/blog/2025/01/XX/v0.15-vue-support-collection-remove#mockinitialstate) for simpler test setup
 
 **Performance:**
-- 10-20% improvement for get/denormalize operations
+- [10-20% improvement](/blog/2025/01/XX/v0.15-vue-support-collection-remove#performance) for get/denormalize operations
 
 **[Breaking Changes:](/blog/2025/01/XX/v0.15-vue-support-collection-remove#migration-guide)**
 
@@ -224,6 +224,25 @@ import {
 - `collapseFixture` - Resolves fixture responses (handles function responses)
 - `createFixtureMap` - Separates fixtures into static map and interceptors
 
+## Performance
+
+Removing ImmutableJS auto-detection overhead and optimizing denormalization code paths provides a **10-20% improvement** for get/denormalize operations. [#3421](https://github.com/reactive/data-client/pull/3421), [#3468](https://github.com/reactive/data-client/pull/3468)
+
+```mermaid
+xychart-beta
+    title "Performance vs v0.14"
+    x-axis ["get large", "get small", "denormalize"]
+    y-axis "Percentage gain" 0 --> 125
+    bar [120, 115, 110]
+    bar [100, 100, 100]
+```
+
+<center>
+
+[Benchmarks over time](https://reactive.github.io/data-client/dev/bench/) | [View benchmark](https://github.com/reactive/data-client/tree/master/examples/benchmark)
+
+</center>
+
 ## Other Improvements
 
 - Fix `getPage` types when paginationField is in body