hive-forge: state the read-state contract in the guard docs
This commit is contained in:
parent
e59e41ec90
commit
4a109fa038
1 changed files with 16 additions and 15 deletions
|
|
@ -260,9 +260,10 @@ to discover valid label names before triaging or to audit the label set.
|
|||
|
||||
<!-- vale write-good.Passive = NO -->
|
||||
- **Read-before-comment guard:** `comment` refuses to post when forge still
|
||||
has an unread notification for the thread (that is, someone commented since
|
||||
you last read it). This prevents accidentally replying to old activity without
|
||||
seeing the new context. Read the thread with `hive-forge view <n>` or
|
||||
has an unread notification for the thread. `hive-forge-notify` marks a
|
||||
thread read when it delivers it as a todo, so the guard catches only
|
||||
activity newer than the last delivery (one 30 s poll) and threads whose
|
||||
delivery failed. Read the thread with `hive-forge view <n>` or
|
||||
`hive-forge comments <n>` (which mark the notification read and clear the
|
||||
block), or pass `--force` to skip the guard.
|
||||
- `comment --body "..."` with backticks in the body: always use
|
||||
|
|
|
|||
Loading…
Reference in a new issue