diff --git a/hive-forge/src/verbs/reopen.rs b/hive-forge/src/verbs/reopen.rs
index 0fed88f5..68208375 100644
--- a/hive-forge/src/verbs/reopen.rs
+++ b/hive-forge/src/verbs/reopen.rs
@@ -17,6 +17,11 @@ pub struct Args {
     pub(crate) number: u64,
 }
 
+/// # Errors
+///
+/// Returns an error when the `PATCH /repos/{repo}/issues/{number}` request
+/// fails (network / non-success status from `patch_json`) or when emitting
+/// the JSON summary via `print_json` fails.
 pub fn run(client: &Client, args: Args) -> Result<()> {
     let repo = client.repo();
     let resp = client.patch_json(