Watch
0
0
Fork
You've already forked hyperhive
0

hive-forge, hivectl, swarmctl: fix clap help passive voice, regen docs

Rewrites every write-good.Passive hit in the hive-forge clap help text
into terse, imperative, active voice (meaning unchanged) and drops
clap-markdown's own fixed footer ('This document was generated
automatically by...') via MarkdownOptions::show_footer(false), since
that string isn't ours to reword and vale flagged it too.

docs/tools/{hivectl,swarmctl,forge}-cli.md are generated from each
crate's clap tree (see hive-forge/src/main.rs's MarkdownDocs verb) —
regenerated here from the fixed source, not hand-edited.

Refs #4549
This commit is contained in:
atlas 2026-09-20 05:38:30 +02:00 • committed by mara
commit f0e3ed04d3
18 changed files with 87 additions and 89 deletions

View file

@ -39,8 +39,8 @@ enum Cmd {
Diff(verbs::diff::Args),
/// Show title + body + comments.
View(verbs::view::Args),
/// Edit the PR's title / body / state / milestone. Fields not passed
/// are left unchanged.
/// Edit the PR's title / body / state / milestone. Fields you don't
/// pass keep their current value.
Edit(verbs::issue_edit::Args),
/// Post a comment on the PR.
Comment(verbs::comment::Args),
@ -55,7 +55,7 @@ enum Cmd {
/// Assign or unassign a user (the PR's assignee list).
#[command(alias = "assign")]
AssignCommitter(verbs::assign::Args),
/// List / add / remove dependencies (issues/PRs this one is blocked by).
/// List / add / remove dependencies (issues/PRs blocking this one).
Dependency(verbs::dependency::Args),
/// List / add / remove emoji reactions on the PR, or on one of its
/// comments with `--comment <id>`.