Move benchmark to benches/ folder

- benches/serde_validation.rs - benchmark source
- benches/README.md - methodology and results documentation
- Registered as example with custom path in Cargo.toml
- Updated SERDE_INTEGRATION.md link to new location

Run with: cargo run --example serde_bench --release --features serde,regex

Author: Claude

domainstack/domainstack/Cargo.toml

@@ -53,6 +53,11 @@ required-features = ["regex"]
 name = "serde_validation"
 required-features = ["serde", "regex"]
 
+[[example]]
+name = "serde_bench"
+path = "benches/serde_validation.rs"
+required-features = ["serde", "regex"]
+
 [dev-dependencies]
 tokio = { version = "1", features = ["macros", "rt-multi-thread", "time"] }
 # Disable default features to avoid pulling in unnecessary database drivers (mysql, postgres)

…tack/domainstack/docs/SERDE_BENCHMARK.md domainstack/domainstack/benches/README.mddomainstack/domainstack/docs/SERDE_BENCHMARK.md renamed to domainstack/domainstack/benches/README.md domainstack/domainstack/docs/SERDE_BENCHMARK.md renamed to domainstack/domainstack/benches/README.md

@@ -138,10 +138,10 @@ Validation overhead is **~0.001%** of a typical API request.
 ## Running the Benchmark
 
 ```bash
-cargo run --example serde_benchmark --release --features serde,regex
+cargo run --example serde_bench --release --features serde,regex
 ```
 
-The benchmark is located at: `domainstack/examples/serde_benchmark.rs`
+The benchmark source is: `benches/serde_validation.rs`
 
 ---
 

…/domainstack/examples/serde_benchmark.rs …/domainstack/benches/serde_validation.rsdomainstack/domainstack/examples/serde_benchmark.rs renamed to domainstack/domainstack/benches/serde_validation.rs domainstack/domainstack/examples/serde_benchmark.rs renamed to domainstack/domainstack/benches/serde_validation.rs

@@ -5,7 +5,7 @@
 //!
 //! Run with:
 //! ```sh
-//! cargo run --example serde_benchmark --release --features serde,regex
+//! cargo run --example serde_bench --release --features serde,regex
 //! ```
 
 use std::time::{Duration, Instant};

domainstack/domainstack/docs/SERDE_INTEGRATION.md

@@ -158,7 +158,7 @@ fn validate_order(order: Order, user: &User) -> Result<(), ValidationErrors> {
 | **Boilerplate** | None | Must call `.validate()` |
 | **Flexibility** | Fixed rules | Context-aware rules |
 | **Partial data** | Not possible | Fully supported |
-| **Performance** | <2% overhead ([benchmarked](./SERDE_BENCHMARK.md)) | Zero overhead until called |
+| **Performance** | <2% overhead ([benchmarked](../benches/README.md)) | Zero overhead until called |
 | **Error type** | `serde::Error` wrapper | Native `ValidationErrors` |
 | **Testing** | Can't create invalid instances | Full control |