Skip to content

Correct the Media & Sharing docs and cover the guidance trim - #969

Merged
selfcontained merged 1 commit into
mainfrom
docs-audit/media-sharing-launch-guidance
Aug 17, 2026
Merged

Correct the Media & Sharing docs and cover the guidance trim#969
selfcontained merged 1 commit into
mainfrom
docs-audit/media-sharing-launch-guidance

Conversation

@selfcontained

Copy link
Copy Markdown
Owner

Nightly docs audit. Deep-dive area was the docs-pane Media & Sharing section (next_focus from the last run), plus one diff-driven addition from #955.

Verified clean

Enumerated as sets in both directions, no change needed: the four sidebar tabs vs MediaSidebarTab, the eight dispatch_pin types, dispatch_share's formats / 32KB content cap / simulator capture / update semantics, the five dispatch_list_media sources, the most-recent-50 media limit, MJPEG-over-CDP streaming with last-frame save, and the eight-pin group auto-collapse with per-agent persistence.

Drift fixed (docs-sections/media.tsx)

  • Reviews tab was described as "human review feedback submitted from the Changes tab". It also shows persona reviewer submissions (reviewerType: "agent" from dispatch_review_submit) — the more common case. The claimed three-value badge set was wrong too: reviews-sidebar-row.tsx maps partially_resolved to the Open label, so only Open and Resolved ever render. Rewritten around what the row actually shows, including the resolved count and the Approved · no feedback state.
  • Lightbox previews never mentioned the Download action (present on every item) or that the copy button copies the image itself for non-text files.
  • Screen streaming omitted the Pop out button that opens the feed in its own window.
  • Shortcut pins — on a touch device every shortcut routes through the confirm dialog regardless of confirm, because the hover tooltip that would otherwise show the prompt is unreachable.
  • dispatch_delete_pin takes ids and group, not just a single id.

Diff-driven addition (docs-sections/plugin.tsx, tips.ts)

#955 added Settings → Agents → Launch guidance → Use short startup rules with no docs coverage. Added a Shorter startup rules subsection: what it drops, that it's a user assertion rather than plugin detection, that only Claude Code and Codex agents trim (OpenCode/Cursor keep the full ruleset), that job runs are untouched, and that it applies at launch. Plus one ambient tip pointing at the new anchor — since: 0.34.2, confirmed with git merge-base --is-ancestor 31df8ecb 2d441f2c.

Deferred to next run

  • docs/03-api-spec.md still has no rows for the agent pins HTTP routes (existing backlog item).
  • Pin batch write modes (dispatch_pins merge vs replace) are agent-facing only; not surfaced in the user docs.

pnpm run format:write, pnpm run check, and the tips unit tests all pass.

🤖 Generated with Claude Code

Media & Sharing deep-dive. Most of the section verified clean as sets in
both directions — the four sidebar tabs against MediaSidebarTab, the eight
pin types, dispatch_share's formats/32KB cap/simulator/update semantics,
the five list_media sources, the most-recent-50 limit, MJPEG-over-CDP
streaming, and the eight-pin group auto-collapse.
What had drifted:
- The Reviews tab was described as "human review feedback submitted from
the Changes tab". It shows persona reviewer submissions too (reviewerType
"agent" from dispatch_review_submit), which is the more common case. The
claimed three-value badge set was also wrong: reviews-sidebar-row maps
partially_resolved to the "Open" label, so only Open and Resolved ever
render. Rewritten around what the row actually shows, including the
resolved count and the "Approved · no feedback" state.
- Lightbox previews never mentioned the Download action, which is on every
item, or that the copy button copies the image itself for non-text files.
- Screen streaming omitted the Pop out button.
- Shortcut pins: on a touch device every shortcut routes through the
confirm dialog regardless of `confirm`, because the hover tooltip that
would otherwise show the prompt is unreachable.
- dispatch_delete_pin takes ids and group, not just a single id.
Also diff-driven, from #955: the Settings → Agents → Launch guidance
toggle had no docs coverage. Added a "Shorter startup rules" subsection to
the Plugin section — what it drops, that it's an assertion rather than
detection, that only Claude Code and Codex trim, that job runs don't, and
that it applies at launch — plus an ambient tip pointing at it (since
0.34.2, confirmed by ancestry against the release commit).
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@selfcontainedselfcontained changed the title Correct the Media &amp; Sharing docs and cover the guidance trimCorrect the Media & Sharing docs and cover the guidance trimAug 17, 2026
@selfcontained
selfcontained merged commit d164f70 into mainAug 17, 2026
1 check passed
@selfcontained
selfcontained deleted the docs-audit/media-sharing-launch-guidance branch August 17, 2026 04:11
Sign up for freeto 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

@selfcontained