From 4a1b5f5d519881fd583f213891f6d3abc3d80116 Mon Sep 17 00:00:00 2001 From: atlas Date: Fri, 18 Sep 2026 22:37:53 +0200 Subject: [PATCH] docs(forge): drop the flat hidden-verb section from the verb reference 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 --- docs/tools/forge.md | 13 ------------- 1 file changed, 13 deletions(-) diff --git a/docs/tools/forge.md b/docs/tools/forge.md index 81391f06..a8fb9489 100644 --- a/docs/tools/forge.md +++ b/docs/tools/forge.md @@ -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 ` / `pr ` 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)