[timhettler]

Expands the --inline section from "a fallback when a proxy isn't an option" into first-class decision guidance, per review discussion.

What

• Reframes inline as often the simplest correct choice for small/moderate icon sets (no proxy, no cross-origin gotcha, no cold-cache flash, SSR'd).
• Adds a "When to reach for --inline" heuristic: inline for small sprites / navigation-light apps; the default static sprite (+ --hash/immutable) for large sets or high-traffic sites; --proxy when that cached file lives on a CDN.
• Keeps the honest cost visible: one copy of the sprite in every HTML document, re-sent per full navigation — which is why inline isn't the default.
• Corrects a stale line that implied the proxy is the default recommendation (the default is the static same-origin sprite).

Docs only.

🤖 Generated with Claude Code