Watch
0
0
Fork
You've already forked hyperhive
0

rewrite generated CLI docs' passive voice to active

hive-forge and hivectl doc-comment strings for pr-create --label, diff
--full, list --label, ci-runs --branch, and several hivectl subcommand
options read as if things happened to themselves. Name the actor (hivectl,
hive-forge, or the CLI) instead, and regenerate the three docs/tools/*-cli.md
files from the rebuilt binaries.

swarmctl-cli.md needs no source change: its only passive hit is
clap-markdown's own generated boilerplate, out of scope here.
This commit is contained in:
iris 2026-09-08 14:46:52 +02:00 • committed by mara
commit 7396903994

View file

@ -71,11 +71,11 @@ pub struct Args {
/// Label name to attach, repeatable (for example `--label area/ops --label
/// type/bug`). Same spelling `labels add` accepts — an unresolved name
/// errors out rather than silently attaching fewer labels than asked
/// for. In `--agit` mode this is applied as a follow-up call once the
/// PR number is known (the `AGit` push itself has no label field), so
/// it's silently skipped (not a label-resolution error) if the PR URL
/// couldn't be parsed back out of the push output — same fallback as
/// the deferred multi-line body.
/// for. In `--agit` mode `pr-create` applies this as a follow-up call
/// once it learns the PR number (the `AGit` push itself has no label
/// field), so it silently skips them (not a label-resolution error) if
/// it couldn't parse the PR URL back out of the push output — same
/// fallback as the deferred multi-line body.
#[arg(long = "label")]
labels: Vec<String>,
}