docs: correct zero-alloc claims to near-zero (fasthttp []byte→string conversions)

Author: jkyberneees

README.md

@@ -158,14 +158,14 @@ Measured on Apple M2 Pro (`go test -bench=. -benchtime=5s`):
 
 ### Key design decisions
 
-- **fasthttp engine**: Built on [fasthttp](https://github.com/valyala/fasthttp) — zero-alloc request handling with pre-allocated per-connection buffers. No per-request allocations on the hot path.
+- **fasthttp engine**: Built on [fasthttp](https://github.com/valyala/fasthttp) — pre-allocated per-connection buffers with near-zero allocation hot path. Cache hits bypass all string formatting; headers are pre-computed at cache-population time.
 - **`tcp4` listener**: IPv4-only listener eliminates dual-stack overhead on macOS/Linux — a 2× throughput difference vs `"tcp"`.
 - **Preload at startup**: `preload = true` reads all eligible files into RAM before the first request — eliminating cold-miss latency.
 - **Direct `ctx.SetBody()` fast path**: cache hits bypass range/conditional logic entirely; pre-formatted `Content-Type` and `Content-Length` headers are assigned directly.
 - **Custom Range implementation**: `parseRange()`/`serveRange()` handle byte-range requests without `http.ServeContent`.
 - **Post-processing compression**: compress middleware runs after the handler, compressing the response body in a single pass.
 - **Path-safety cache**: `sync.Map`-based cache eliminates per-request `filepath.EvalSymlinks` syscalls. Pre-warmed from preload.
-- **GC tuning**: `gc_percent = 400` reduces garbage collection frequency — the hot path is allocation-free.
+- **GC tuning**: `gc_percent = 400` reduces garbage collection frequency — the hot path avoids all formatting allocations, with only minimal byte-to-string conversions from fasthttp's `[]byte` API.
 - **Cache-before-stat**: `os.Stat` is never called on a cache hit — the hot path is pure memory.
 - **Zero-alloc `AcceptsEncoding`**: walks the `Accept-Encoding` header byte-by-byte without `strings.Split`.
 - **Pre-computed `ETagFull`**: the `W/"..."` string is built when the file is cached.

docs/index.html

@@ -96,7 +96,7 @@
               "In-memory LRU cache with ~28 ns/op lookup",
               "Startup preloading with path-safety cache pre-warming",
               "TTL-aware cache expiry with optional automatic stale-entry eviction",
-              "Direct ctx.SetBody() zero-alloc fast path for cache hits",
+              "Direct ctx.SetBody() fast path with pre-formatted headers for cache hits",
               "HTTP/2 with automatic HTTPS",
               "TLS 1.2+ with AEAD cipher suites",
               "gzip and brotli compression",
@@ -234,7 +234,7 @@ <h1 class="hero-title">static-web</h1>
           </div>
           <div class="stat-divider" aria-hidden="true"></div>
           <div class="stat">
-            <span class="stat-value">0 alloc</span>
+            <span class="stat-value">~0 alloc</span>
             <span class="stat-label">hot-path serving</span>
           </div>
           <div class="stat-divider" aria-hidden="true"></div>
@@ -299,8 +299,8 @@ <h2 class="section-title" id="features-heading">Everything You Need</h2>
           <div class="features-grid">
             <div class="feature-card">
               <div class="feature-icon">⚡</div>
-              <h3>Zero-Alloc Hot Path</h3>
-                <p><strong>~141k req/sec</strong> — 55% faster than Bun. Built on fasthttp with direct <code>ctx.SetBody()</code> and pre-formatted headers — zero allocations on the hot path.</p>
+              <h3>Near-Zero Alloc Hot Path</h3>
+                <p><strong>~141k req/sec</strong> — 55% faster than Bun. Built on fasthttp with direct <code>ctx.SetBody()</code> and pre-formatted headers — no formatting allocations on cache hits.</p>
             </div>
             <div class="feature-card">
               <div class="feature-icon">🗜️</div>