Skip to content

docs(commands): trim the navigation, target, and runner reference - #3443

Merged
thymikee merged 3 commits into
mainfrom
docs/commands-lifecycle
Oct 11, 2026
Merged

thymikee merged 3 commits into
mainfrom
docs/commands-lifecycle

Conversation

@thymikee

@thymikee thymikee commented Oct 11, 2026 •

Copy link
Copy Markdown
Member

Summary

The third of three family-scoped trims of commands.md. This one covers the intro through Desktop targets. The range drops from about 5,970 to 3,850 words (−36%). Every command, flag, example, error reason and recovery step is kept.

  • Intro: the 20-line help-topic list is now four lines; agent-device help prints the topic list itself.
  • Navigation: split into labelled groups. iOS launch prompts, action-button and fold are condensed, and fold details point to agent-device help foldable.
  • Prepare Apple runner: internal cache detail is cut (build-scratch trimming and sizes, cache-key internals). Every error reason with its fix, the CI cache rule, and AGENT_DEVICE_IOS_RUNNER_CACHE_KEEP are kept.
  • sessions.md gains "Release a device another workspace holds", covering device status, device release --stale, live vs dead owners, and reboots. The slow-device section now covers the 90-second default and boot_timeout.
  • No headings changed, so all linked anchors still resolve.

Companion to #3441 and #3442. Each edits a different range of commands.md.

Validation

  • pnpm check:affected --run passed on 08aee6a.
  • The four tests that pin commands.md text pass.
  • check:doc-prose and check:doc-links pass.
  • Docs only, so no device runs.

🤖 Generated with Claude Code

View guided diff Turn on auto-fix

thymikee and others added 2 commits October 11, 2026 19:40
Condense Navigation, Web Automation, isolation scopes, discovery, Prepare
Apple runner, TV, and Desktop targets; move device-claim release and boot
timeout recovery into Sessions; collapse the help topic list.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Oct 11, 2026 •

Copy link
Copy Markdown
Contributor
PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-10-11 18:54 UTC

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed across 3 files

Reply with feedback, questions, or to request a fix.

View guided diff | Turn on auto-fix | Re-trigger cubic

Comment thread website/docs/docs/commands.md Resolved
Comment thread website/docs/docs/sessions.md Resolved
Comment thread website/docs/docs/sessions.md Resolved
Comment thread website/docs/docs/commands.md Resolved
Comment thread website/docs/docs/commands.md Resolved
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@thymikee

Copy link
Copy Markdown
Member Author

This PR is ready at 08aee6a. The trim keeps all error reasons, flags and defaults, and I found nothing that needs a change. All 11 reported checks are passing, and the diff touches only website docs. No conflicts, and nothing else stands in the way of merge. Not blocking: the trim in website/docs/docs/commands.md drops a few details that no other doc states, namely the Apple runner's xcodebuild scoping with -DVTSimulatorSetLocation, the fold-helper rebuild conditions, the action-button comparison with home and app-switcher timing, and the note that open returns no launchConfirmation field when no prompt appears. Most of these are internal. If you restore one, make it the launchConfirmation note, since a script that checks for the field may want to know it can be absent. Take them or leave them. On evidence, I spot-checked the reasons, anchors and the foldable topic, but I did not check every retained statement against the registry or help text. I did not read the fold help topic body or device-claim-settlement.ts, and I did not run the doc tests or gates locally.

@thymikee thymikee added the ready-for-human Valid work that needs human implementation, judgment, or maintainer merge label Oct 11, 2026
@thymikee
thymikee merged commit a682dc5 into main Oct 11, 2026
11 checks passed
@thymikee
thymikee deleted the docs/commands-lifecycle branch October 11, 2026 18:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ready-for-human Valid work that needs human implementation, judgment, or maintainer merge

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant