No explanatory callouts on much-visited pages — D20 (#659) #679

Merged
claude-bot merged 1 commit from feat/659-d20-no-callouts into main 2026-09-16 21:34:03 +00:00
Collaborator

Owner decision, recorded as D20: on a surface people open constantly, don't explain and don't point at Settings. Assume someone who needs to change a thing will look in Settings, or in Help. These read as helpfulness while writing and as clutter on the fourth visit.

Cut from This week

Removed Why it went
"Shown in your timezone — change it in your profile" The one that prompted this. A signpost to a setting, on the most-opened page in the app.
".ics works with Apple Calendar, Outlook and anything else that reads calendar files" True, read once, furniture thereafter. This is SE-149, a real catalogued row, so the removal is written onto CAMP-1's summary rather than left for the rebuild to quietly restore.
"Change it any time before Monday" The RSVP confirmation keeps "Saved — you're in." and the answered count. The reassurance is for the first time only.
The table card's two sentences Trimmed to "Opens by itself when recording starts." The automatic switch into Table mode is genuinely non-obvious, so the fact survives; the paragraph does not.

Deliberately kept

"Anything you raise here is anonymous — no name is stored, ever" on the safety card. That is not a description of where a setting lives; it is the reason somebody presses the button. Under-explaining there costs something real.

The helper text on the settings forms and the new-session form. Those are infrequent or one-off surfaces — "it is not your timezone, it is the table's" is read exactly when it is needed and nowhere else. D20 names the surfaces it governs so this distinction is written down rather than re-argued each lane.

Why it is a decision and not a tweak

It changes what lanes 3–8 get drawn with, and it removes a catalogued feature (SE-149). Both belong in the record rather than in a commit message, so D20 is in the decisions table with its scope and its exceptions, and CAMP-1's summary carries it.

Verified by rendering: the timezone callout is gone from all three places it appeared, the only remaining mention is the decision text quoting it, and This week reads noticeably quieter.

🤖 Generated with Claude Code

Owner decision, recorded as **D20**: on a surface people open constantly, don't explain and don't point at Settings. Assume someone who needs to change a thing will look in Settings, or in Help. These read as helpfulness while writing and as clutter on the fourth visit. ## Cut from This week | Removed | Why it went | |---|---| | "Shown in your timezone — change it in your profile" | The one that prompted this. A signpost to a setting, on the most-opened page in the app. | | ".ics works with Apple Calendar, Outlook and anything else that reads calendar files" | True, read once, furniture thereafter. This is **`SE-149`**, a real catalogued row, so the removal is written onto CAMP-1's summary rather than left for the rebuild to quietly restore. | | "Change it any time before Monday" | The RSVP confirmation keeps "Saved — you're in." and the answered count. The reassurance is for the first time only. | | The table card's two sentences | Trimmed to "Opens by itself when recording starts." The automatic switch into Table mode is genuinely non-obvious, so the fact survives; the paragraph does not. | ## Deliberately kept **"Anything you raise here is anonymous — no name is stored, ever"** on the safety card. That is not a description of where a setting lives; it is the reason somebody presses the button. Under-explaining there costs something real. **The helper text on the settings forms and the new-session form.** Those are infrequent or one-off surfaces — "it is not your timezone, it is the table's" is read exactly when it is needed and nowhere else. D20 names the surfaces it governs so this distinction is written down rather than re-argued each lane. ## Why it is a decision and not a tweak It changes what lanes 3–8 get drawn with, and it removes a catalogued feature (`SE-149`). Both belong in the record rather than in a commit message, so D20 is in the decisions table with its scope and its exceptions, and CAMP-1's summary carries it. Verified by rendering: the timezone callout is gone from all three places it appeared, the only remaining mention is the decision text quoting it, and This week reads noticeably quieter. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
feat(feedback-site): no explanatory callouts on much-visited pages (#659)
All checks were successful
CI / Backend lint (ruff) (pull_request) Successful in 1m0s
CI / Bot/backend version sync (pull_request) Successful in 54s
CI / Docker image build (pull_request) Successful in 20s
CI / Summarisation accuracy eval harness (stub provider) (pull_request) Successful in 1m44s
CI / Bot tests and audit (pull_request) Successful in 2m47s
CI / Frontend tests, audit, and build (pull_request) Successful in 3m18s
CI / Backend migration, tests, and audit (pull_request) Successful in 12m57s
CI / Synthetic session harness (no GPU, no LLM) (pull_request) Successful in 17m23s
74c6492ffc
Owner decision, recorded as D20: on a surface people open constantly,
don't explain and don't point at Settings. Someone who needs to change
a thing will look in Settings or in Help. These read as helpfulness
while writing and as clutter on the fourth visit.

Cut from This week:
- "Shown in your timezone — change it in your profile" (the one that
  prompted this)
- the .ics compatibility note, "works with Apple Calendar, Outlook and
  anything else that reads calendar files" — this is SE-149, a real
  catalogued row, so the removal is noted on CAMP-1's summary rather
  than left for the rebuild to put back
- "Change it any time before Monday" from the RSVP confirmation, which
  keeps "Saved — you're in." and the answered count
- the table card's prose, trimmed from two sentences to "Opens by itself
  when recording starts."

Deliberately kept: "anything you raise here is anonymous — no name is
stored, ever" on the safety card. That is not a description of where a
setting lives, it is the reason somebody presses the button.

Also kept: the helper text on the settings forms and on the new-session
form. Those are one-off or infrequent surfaces, where the words are read
exactly when they are needed.

D20 is written into the catalogue's decisions table and names the
surfaces it governs, so it holds for lanes 3 to 8 as well.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
claude-bot scheduled this pull request to auto merge when all checks succeed 2026-09-16 21:15:33 +00:00
claude-bot deleted branch feat/659-d20-no-callouts 2026-09-16 21:34:03 +00:00
Sign in to join this conversation.
No description provided.