diff --git a/docs/spa-conventions.md b/docs/spa-conventions.md
index d70e663aa..9ce223c0e 100644
--- a/docs/spa-conventions.md
+++ b/docs/spa-conventions.md
@@ -667,9 +667,9 @@ channel-preview panel wires it to a "press play" hint whose visibility is the re
 `state === 'starting'` **alone**, so a second clear in `onPlaying` would be a guard no test could
 distinguish. That holds because the panel's paths back to `starting` either clear the flag themselves
 (Retry, a channel change) or cannot be reached while it is set — the forced-preview opt-in re-enters
-`starting` without clearing, but its button renders only before the player has ever mounted, so the
-flag is necessarily false there. The panel never claims the fault fixed itself; the hint mirrors an
-honest, still-not-playing state.
+`starting` without clearing, but its button renders only while the panel has not started, and the
+only thing that un-starts it is the channel reset that clears the flag. The panel never claims the
+fault fixed itself; the hint mirrors an honest, still-not-playing state.
 
 **Resolving a `/iptv/*` src under JWT auth (#552).** Before feeding an `/iptv/*` manifest URL to
 `HlsPlayer`, pass it through `withIptvToken(url)` (`web/src/media/iptvToken.ts`): under a JWT-enabled