diff --git a/xmr-btc/src/lib.rs b/xmr-btc/src/lib.rs
index c24ed222..8842e8df 100644
--- a/xmr-btc/src/lib.rs
+++ b/xmr-btc/src/lib.rs
@@ -122,8 +122,11 @@ where
         AfterBtcLock(Reason),
     }
 
+    /// Reason why the swap has failed.
     enum Reason {
+        /// The refund timelock has been reached.
         BtcExpired,
+        /// Alice did not lock up enough monero in the shared output.
         InsufficientXMR(monero::InsufficientFunds),
     }