diff --git a/hive-forge/src/verbs/subscription.rs b/hive-forge/src/verbs/subscription.rs
index abc0467e..2c6a51fd 100644
--- a/hive-forge/src/verbs/subscription.rs
+++ b/hive-forge/src/verbs/subscription.rs
@@ -32,6 +32,13 @@ pub struct Args {
     list: bool,
 }
 
+/// Run the `subscription` verb: `--list` all watched repos, set the
+/// current repo's watch (`--watch` / `--ignore` / `--unwatch`), or get
+/// its current state.
+///
+/// # Errors
+/// Propagates transport / non-2xx errors from the Forgejo client calls
+/// (`get_json` / `put_json` / `delete`) and from `print_json`.
 pub fn run(client: &Client, args: Args) -> Result<()> {
     if args.list {
         // List every repo the authed user watches, so an agent can audit