docs, prompts, hive-forge: stop handing readers the renamed verbs
docs/tools/forge.md already listed the nine renamed verbs as removed, then used them ~30 more times in pasteable blocks. Sweeps every occurrence a reader would type, including three runtime messages that told the user to run a verb the same binary rejects. The renamed-verb list itself keeps the old names; it is what documents them. Refs #4155
This commit is contained in:
parent
d2175c84b3
commit
55f01942a2
23 changed files with 73 additions and 73 deletions
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
name: forge-issue-filing
|
||||
description: How to file a well-formed forge issue through the hive-forge CLI - check for an existing duplicate first (title-only grepping misses it, use server-side --search), pick a title that states the problem not the symptom, write a body that's the *problem*, and put any proposed fix in a follow-up comment rather than the issue description. Use this whenever you're about to run `hive-forge issue-create`, whenever you hit a bug/gap/usability problem and are about to file it rather than silently work around it, or whenever asked to write up a finding as an issue.
|
||||
description: How to file a well-formed forge issue through the hive-forge CLI - check for an existing duplicate first (title-only grepping misses it, use server-side --search), pick a title that states the problem not the symptom, write a body that's the *problem*, and put any proposed fix in a follow-up comment rather than the issue description. Use this whenever you're about to run `hive-forge issue create`, whenever you hit a bug/gap/usability problem and are about to file it rather than silently work around it, or whenever asked to write up a finding as an issue.
|
||||
---
|
||||
|
||||
# Forge Issue Filing
|
||||
|
|
@ -55,7 +55,7 @@ proposed implementation - post that as a **follow-up comment**, not baked
|
|||
into the description:
|
||||
|
||||
```sh
|
||||
hive-forge issue-create --title "..." --body "..." --label ... --assignee ...
|
||||
hive-forge issue create --title "..." --body "..." --label ... --assignee ...
|
||||
hive-forge comment <number> --body "proposed fix: ..."
|
||||
```
|
||||
|
||||
|
|
@ -74,7 +74,7 @@ separate from the problem statement.
|
|||
|
||||
## 4. Labels: check the taxonomy, don't guess
|
||||
|
||||
Label names are repo-specific and an unresolved name in `issue-create
|
||||
Label names are repo-specific and an unresolved name in `issue create
|
||||
--label` errors out before the issue is even created (better than the
|
||||
alternative, but still wasted effort if you guess wrong). If you don't
|
||||
already know the repo's label scopes, list them first:
|
||||
|
|
@ -107,7 +107,7 @@ unassigned and let it surface through the normal triage sweep (see the
|
|||
```sh
|
||||
hive-forge list --search "thing you think is broken" --state all # 1: dedup
|
||||
hive-forge repo-labels # 4: taxonomy
|
||||
hive-forge issue-create \
|
||||
hive-forge issue create \
|
||||
--title "the problem, stated durably" \
|
||||
--body "what's wrong, how to reproduce, where it bites" \
|
||||
--label area/whatever --label type/bug
|
||||
|
|
|
|||
Loading…
Reference in a new issue