Skip to content

[docs] website and README: sell what Parley actually is now - #252

Merged
YJack0000 merged 1 commit into
mainfrom
claude/website-content-update-9d0e98
Aug 17, 2026
Merged

YJack0000 merged 1 commit into
mainfrom
claude/website-content-update-9d0e98

Conversation

@YJack0000

Copy link
Copy Markdown
Contributor

The site and the README were still selling three subsystems that shipped their last release weeks ago — the live intelligence board, the accounts mini-CRM, and live voice translation — while the thing that actually grew, the MCP server, got one code block and three bullet points.

Both are rewritten around where the app converged in v0.22.14–v0.22.18: record, transcribe, analyze, search, and an MCP surface wide enough that an external agent can own the library, including the analysis.

website/index.html

  • Positioning. Hero, meta description, keywords, OG/Twitter cards and JSON-LD rewritten around the record + MCP story instead of real-time coaching. Pre-flight is gone from the workflow steps; the meeting context field replaces the meeting-type picker, which is what update_recording_meta now tells an agent to write.
  • MCP becomes the headline section, growing from one code block to all 48 tools in five groups — live meeting, cross-meeting search, personal library, the org side, and handing the analysis over. Every tool name was checked against src-tauri/src/mcp.rs. The auto-analyze-off flow from [feature] settings: auto-analyze toggle so an external AI can own recording analysis #230 / [feature] MCP external-analysis surface: recording-level write-back for external AI analysts #229 is spelled out, because nothing on the site explained why you would ever turn analysis off.
  • iPhone gets its real App Store link (id6795031201) instead of the "in review" placeholder. Android is described honestly: built, syncs to the same account, records the room and imports audio — and not on Google Play yet.
  • Footer regrouped into Product / Project / Legal & support. Account deletion comes out of the top-level footer nav and sits under Legal; /account-deletion/ itself is untouched, since Play requires that URL to stay reachable.
  • Pathors is de-emphasised. The nav link and the "A Pathors AI open source project" line are gone, the JSON-LD Organization graph collapses to a single author field, and the open-source section explains the origin ("an internal tool, opened up") without leaning on the brand. Copyright and one footer link remain.

website/{privacy,support,account-deletion}/

English-only, per the repository convention. All three were lang="zh-Hant" with an "English summary" bolted on the end, so every fact was stated twice and could drift. Support also gains three desktop entries that did not exist in either language: a failed system-audio tap, an MCP client that cannot connect, and analysis not running because auto-analyze is off.

README.md

Drops the live-translation section, the "add a Gemini key and install the Parley Microphone" install step, and the cd virtual-mic && ./build.sh build step. Adds the MCP server as a first-class section with the tool table and the external-analyst flow.

Deleted

website/assets/showcase-accounts.png — it pictures the accounts mini-CRM removed in #245, and nothing referenced it any more.

Known follow-up

The remaining desktop screenshots predate the removals and need a reshoot. showcase-hero.png is the worst case: its right-hand column is the intel board, so the largest image on the landing page (and at the top of this README) advertises a feature that no longer exists. All the desktop shots are from 3–11 July, before the 14–17 August removals; the two iPhone shots are from 10 August, before the restyle in #248.

Verification

bunx tsc --noEmit and bunx vitest run both pass (216 tests). No source files changed. The page was checked at 1280px and 375px — no horizontal overflow, and the new tool grid and footer columns reflow correctly.

The site and the README were still selling three subsystems that shipped
their last release weeks ago — the live intelligence board, the accounts
mini-CRM, and live voice translation — while the thing that actually grew,
the MCP server, got one code block and three bullet points.

Both are rewritten around where the app converged in v0.22.14–v0.22.18:
record, transcribe, analyze, search, and an MCP surface wide enough that an
external agent can own the library, including the analysis.

website/index.html
- Hero, metadata, OG/Twitter cards and JSON-LD rewritten around the record +
  MCP story instead of real-time coaching. Pre-flight is gone from the
  workflow steps; meeting context replaces the meeting-type picker.
- The MCP section grows from one code block to all 48 tools in five groups,
  each name checked against src-tauri/src/mcp.rs, plus the auto-analyze-off
  handover flow that #230 and #229 built.
- The iPhone section gets the real App Store link (id6795031201). Android is
  described honestly as built and syncing but not on Play yet.
- Footer regrouped into Product / Project / Legal & support; account deletion
  moves out of the top-level nav into Legal (the /account-deletion/ URL is
  unchanged — Play requires it to stay reachable).
- Pathors is de-emphasised: the nav link and the "A Pathors AI open source
  project" line are gone, the JSON-LD Organization graph collapses to a single
  author field, and the open-source section explains the origin without
  leaning on the brand.

website/{privacy,support,account-deletion}
- English-only, per the repository convention. lang was zh-Hant with an
  "English summary" appended; now there is one language and no duplication.
- Support gains three desktop entries that did not exist before: a failed
  system-audio tap, an MCP client that cannot connect, and analysis not
  running because auto-analyze is off.

README.md
- Drops the live-translation section, the Gemini-key install step and the
  virtual-mic build step. Adds the MCP server as a first-class section with
  the tool table and the external-analyst flow.

showcase-accounts.png is deleted: it pictures the accounts mini-CRM removed
in #245 and nothing referenced it any more.

Note that the remaining desktop screenshots predate the removals — hero still
shows the intel board — and need a reshoot in a follow-up.
@sonarqubecloud

Copy link
Copy Markdown

@YJack0000
YJack0000 merged commit c3f39bd into main Aug 17, 2026
1 check passed
@YJack0000
YJack0000 deleted the claude/website-content-update-9d0e98 branch August 17, 2026 11:33
YJack0000 added a commit that referenced this pull request Aug 18, 2026
…eature claims (#256)

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/.
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