diff --git a/crates/matrix-sdk/src/error.rs b/crates/matrix-sdk/src/error.rs
index 84d047478..91a708945 100644
--- a/crates/matrix-sdk/src/error.rs
+++ b/crates/matrix-sdk/src/error.rs
@@ -47,8 +47,11 @@ pub type HttpResult<T> = std::result::Result<T, HttpError>;
 /// representation if the endpoint is from that.
 #[derive(Error, Debug)]
 pub enum RumaApiError {
+    /// A client API response error.
     #[error(transparent)]
     ClientApi(ruma::api::client::Error),
+
+    /// Another API reponse error.
     #[error(transparent)]
     Other(ruma::api::error::MatrixError),
 }