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
|
|
@ -2,8 +2,10 @@
|
|||
//! issue or PR.
|
||||
//!
|
||||
//! Read-before-comment guard: before posting, refuse when forge still
|
||||
//! has an unread notification for the thread — i.e. someone commented
|
||||
//! since the caller last read it. Reading the thread
|
||||
//! has an unread notification for the thread. `hive-forge-notify` marks
|
||||
//! a thread read when it delivers it as a todo, so this only catches
|
||||
//! activity newer than the last delivery (about one 30 s poll) and
|
||||
//! threads whose delivery failed. Reading the thread
|
||||
//! (`hive-forge comments <n>` / `view <n>`) marks the notification read
|
||||
//! and clears the block; `--force` overrides. The unread signal is
|
||||
//! forge's own notification read-state, not a local mirror — see
|
||||
|
|
|
|||
Loading…
Reference in a new issue