[worktrunk-bot]

Summary

Follow-up to #3096, per maintainer request. Swept every (e.g., ...) parenthetical in the CLI help surface (src/cli/mod.rs, src/cli/step.rs, src/cli/config.rs) and dropped the one that matched the same shape as the feature-fix example removed in #3096 — a generic placeholder name that restates the surrounding phrase without clarifying it.

Removed

src/cli/step.rs:180 — wt step push long help opener:

Before: "Updates the local target branch (e.g., main) to include current commits."

After: "Updates the local target branch to include current commits."

The example block right below already shows both the default-target case (wt step push # Fast-forward main to current branch) and the override case (wt step push develop # Fast-forward develop instead), so the inline main example is doubly redundant. "Target branch" is self-explanatory; main adds no information.

Kept (and why)

Every other (e.g., ...) in CLI help text was preserved as a useful clarification. The kept instances fall into three categories:

1. Specific named tools / mechanisms — anchor an abstract phrase to a real, named thing the reader can recognize.

   • mod.rs:373 — "hooks handle navigation (e.g., tmux workflows)"
   • mod.rs:387 — "tool integration (e.g., Claude Code WorktreeCreate hooks)"
   • mod.rs:569 — "Switching to a remote branch (e.g., wt switch feature when only origin/feature exists)" (already noted in docs(switch): refine wt switch --help text #3096)
   • mod.rs:767 — "no number is available (e.g. branch workflows without a PR/MR)"
   • mod.rs:962 — "review is required (e.g. branch protection)"
   • mod.rs:1446 — "output budget is tight (e.g., Unix socket paths capped at 107 bytes)"
   • step.rs:644 — "at each other's expected locations (e.g., alpha at repo.beta and beta at repo.alpha)"

2. Concrete git/config refs that ground abstract terms — name the actual git ref or value the reader will see.

   • mod.rs:1029 — "its upstream (e.g., origin/main) when strictly ahead"
   • mod.rs:1567 — "references the key conditionally (e.g. {% if override %}…{% endif %})"
   • config.rs:781 — "checks its HEAD (e.g., origin/HEAD)"
   • config.rs:883 — "Path to one hook log (e.g. the post-start server hook for the current branch)"

3. Table rows and TOML comments illustrating value format — show what a field's value actually looks like; the canonical examples convention in .claude/skills/writing-user-outputs.

   • mod.rs:884 ("!?↓"), mod.rs:919 ("origin"), mod.rs:1378 (pre-start, pre-merge), mod.rs:1405 (TOML rebase config), mod.rs:1436 (myproject.malleable-opah), mod.rs:1665–1671 (template variable resolutions), mod.rs:1826 (TOML excludes), mod.rs:2138 (powershell)
   • config.rs:834 (wt hook pre-merge --yes), config.rs:835 (pre-merge user:lint)

Testing

• cargo test --test integration test_docs_are_in_sync — passes.
• cargo test --test integration test_help — passes (no help snapshot covers wt step push --help long help; the change is only visible at runtime).
• cargo build — clean.
• Ran wt step push --help locally to verify the rendered output reads cleanly.

Notes for review

• Based on top of docs(step): regen wt step eval --format mirror #3109 so CI passes. Once docs(step): regen wt step eval --format mirror #3109 lands this can rebase onto main.