vinzenz/hyperhive
vinzenz/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 2

docs(forge): drop the flat hidden-verb section from the verb reference

Browse source 
pr-create/pr-status/etc no longer parse -- clap deleted them along
with the renamed() helper. The remaining flat verbs (view, comment,
close, ...) are #[command(hide = true)] in clap; documenting a
deliberately hidden set as a group defeats the point of hiding it.
The examples further down that demonstrate individual hidden verbs
are unaffected.

Refs #4509
This commit is contained in:
atlas 2026-09-18 22:37:53 +02:00
commit 4a1b5f5d51
1 changed files with 0 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

13
docs/tools/forge.md
View file

@ -31,19 +31,6 @@ refuses an issue number, which the old generic `close` couldn't). Run
list (show/create/edit/status/merge/reviews/commits/diff/view/comment/
comments/close/reopen/labels/assign/dependency/reaction/timeline as applicable).
The flat forms are two different groups, and `--help` hides both, so the
difference can't be seen from the CLI and is stated here instead:
- **Renamed — these no longer run.** `issue-create` `issue-edit` `pr-create`
`pr-status` `pr-merge` `pr-reviews` `pr-commits` `pr-assign-reviewer` `diff`
parse only far enough to print the namespaced form that replaced them, and
are removed outright in a later release.
- **Kind-agnostic — these stay.** `view` `comment` `comments` `close` `assign`
`labels` `timeline` are the only way to act on a number without already
knowing whether it's an issue or a PR, which no namespaced form offers.
Hidden, but supported; prefer `issue <verb>` / `pr <verb>` when the kind is
known, since those validate it.
```bash
hive-forge pr close 42 # close a PR (kind-validated)
hive-forge pr reopen 42 # reopen a closed PR (kind-validated)