Skip to content

[docs] reshoot the product screenshots, and retire the last removed-feature claims - #256

Merged
YJack0000 merged 1 commit into
mainfrom
claude/docs-and-screenshots-refresh
Aug 18, 2026
Merged

YJack0000 merged 1 commit into
mainfrom
claude/docs-and-screenshots-refresh

Conversation

@YJack0000

Copy link
Copy Markdown
Contributor

#252 rewrote the words on parley.tw to stop promising features the app no longer has. The pictures kept promising them. This finishes the job, and clears the last removed-feature claims out of the store listings.

The screenshots

Five of the six desktop shots predated the v0.22.14–v0.22.16 removals. The worst was showcase-hero — the largest image on the landing page and the first image in the README — whose right-hand column was the intel board removed in #247.

Reshot against current main, seeded through the store with a fictional renewal negotiation (Northwind Logistics / Dana Whitfield; no real customer data):

Slot What changed
showcase-hero The live cockpit as it is now — transcript, coach feed, agenda checklist. No intel board, because there is none.
showcase-transcript The transcript posture with the findings column.
showcase-study The report: brief with clickable timestamp pills, action items with severity, filed into a customer folder.
showcase-qa Ask, in the drawer it actually lives in. The old shot still had the v0.11 "Ask / TODO" tab pair and the old delivery panel.
showcase-eval Settings → Evaluations — the built-in playbooks and an editable prompt, which is what "your checks" means concretely.

Kept deliberately: showcase-voicetyping — the overlay has had only behaviour fixes since it was shot (screen placement, tap-to-toggle, preview cap), no visual redesign. The two iPhone shots predate the #248 restyle so they are next in line, but they show nothing that no longer exists.

The capture shims (a store handle in main.tsx, a thread seeder in AskPanel) are reverted, not committed, per the standing recipe — grep for them comes back clean.

The store listings

All four locale files still sold "deal intelligence" / 成交情報 — the mini-CRM removed in #245 — in the paragraph telling a phone user what they get on the desktop. Replaced with cross-meeting search, which is what actually replaced it.

Two open items that were already closed

#235 shipped Android in-app account deletion and the web deletion route, but the docs never caught up:

  • android/AppStore/data-safety.md opened with "[TODO: confirm with Jack] — this must be resolved before the form is submitted" and three hypothetical ways out. Both routes exist now (verified: AccountSheet.kt → HomeViewModel.deleteAccount() → CloudClient.deleteAccount() → DELETE /me), so it states the answers to give on the Play form instead.
  • Both listings pointed at parley.tw/privacy/ for deletion; they now point at parley.tw/account-deletion/.

The remaining [TODO: confirm with Jack] markers in that file are left alone on purpose — they are genuine questions for a human (whether to over-declare usage data for cross-store consistency, and whether api.parley.tw retains account-linked request logs).

One real gap is now stated rather than buried: Android still has no in-app deletion of a single recording (CloudClient.deleteRecording has no caller). That is a product gap, not a compliance one, and the file says so.

Smaller corrections

  • iOS is 1.2 on the App Store (released 2026-08-15), not 1.1 — checked against the iTunes lookup API, not assumed.
  • The iOS listing's rationale notes argued for a name and a subtitle it does not ship ("Parley: Meeting Recorder", "the subtitle does not mention voice typing" — it leads with it).
  • CLAUDE.md listed interpreter among the secondary windows; that window went with [refactor] remove live translation and the interpreter #242.
  • docs/design/mini-crm.md now says up front that it documents a subsystem that was built and then removed (recoverable at archive/accounts-before-removal), rather than reading as current design.

Historical records — .github/release-notes/** and the D-numbered decision rows in docs/design/ios-app.md — are left untouched.

Verification

  • bunx tsc --noEmit passes
  • bunx vitest run — 221 tests pass
  • All eight media slots load at their intended dimensions against a local serve of website/, and the hero renders correctly inside the site's window frame

…eature claims

Five of the six desktop screenshots predated the v0.22.14–v0.22.16 removals.
The worst was the hero, which is both the largest image on parley.tw and the
first image in the README: its right-hand column was the intel board, removed
in #247. The page around it had already been rewritten in #252 to stop
promising that feature; the picture kept promising it anyway.

Reshot against current main, seeded through the store with a fictional renewal
negotiation (Northwind Logistics / Dana Whitfield — no real customer data):

- showcase-hero — the live cockpit as it actually is now: transcript, coach
  feed, agenda checklist. No intel board, because there is no intel board.
- showcase-transcript — the transcript posture with the findings column.
- showcase-study — the report: brief with clickable timestamp pills, action
  items with severity, filed into a customer folder.
- showcase-qa — Ask, in the drawer it actually lives in now. The old shot
  still had the v0.11 "Ask / TODO" tab pair and the old delivery panel.
- showcase-eval — Settings → Evaluations, showing the built-in playbooks and
  an editable prompt, which is what "your checks" means concretely.

showcase-voicetyping is kept: the overlay has only had behaviour fixes since it
was shot (screen placement, tap-to-toggle, preview cap), no visual redesign.
The two iPhone shots are also kept — they predate the #248 restyle, so they are
next in line, but they show nothing that no longer exists.

The capture shims (a store handle in main.tsx, a thread seeder in AskPanel) are
reverted, not committed, per the standing recipe.

Alongside that, the store listings still sold "deal intelligence" / 成交情報 —
the mini-CRM removed in #245 — in all four locale files, in the paragraph that
tells a phone user what they get on the desktop. Replaced with cross-meeting
search, which is what actually replaced it.

Also settled two stale open items that #235 had already resolved without the
docs catching up: Android does ship in-app account deletion, and
parley.tw/account-deletion/ is the Play-required web route, so
`android/AppStore/data-safety.md` no longer opens with a TODO gate and the
listings point at the real URL rather than the privacy policy. The remaining
`[TODO: confirm with Jack]` markers there are genuine questions for a human
(whether to over-declare usage data, and whether api.parley.tw retains
account-linked request logs) and are left alone.

Smaller corrections: iOS is 1.2 on the App Store, not 1.1; the iOS listing's
rationale notes described a name and a subtitle it does not ship; CLAUDE.md
listed "interpreter" among the secondary windows, which went with #242; and
docs/design/mini-crm.md now says up front that it documents a subsystem that
was built and then removed, rather than reading as current design.

Verified: bunx tsc --noEmit and bunx vitest run (221 tests) pass, and all eight
media slots load at their intended dimensions on a local serve of website/.
@sonarqubecloud

Copy link
Copy Markdown

@YJack0000
YJack0000 merged commit 93249c1 into main Aug 18, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant