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

@ -29,8 +29,8 @@ use crate::verbs::{comment_reactions, issue_reactions, print_json};
#[derive(ClapArgs)]
pub struct Args {
/// Issue or PR number. Ignored (but still required) when
/// `--list-allowed` is set.
/// Issue or PR number. Ignored (but still required) when you pass
/// `--list-allowed`.
pub(crate) number: u64,
/// Target a specific comment's reactions instead of the issue/PR
/// itself — the comment's own id (from `comments`/`comment-show`),
@ -48,7 +48,7 @@ pub struct Args {
#[derive(Subcommand)]
enum Action {
/// List reactions (default when no action is given).
/// List reactions (default when you give no action).
List,
/// Add a reaction — a Forgejo shortcode, for example `+1`, `heart`, `rocket`.
Add { content: String },