diff --git a/crates/matrix-sdk/src/encryption/identities/users.rs b/crates/matrix-sdk/src/encryption/identities/users.rs
index 95e38751e..5aa183193 100644
--- a/crates/matrix-sdk/src/encryption/identities/users.rs
+++ b/crates/matrix-sdk/src/encryption/identities/users.rs
@@ -61,8 +61,8 @@ use crate::{encryption::verification::VerificationRequest, room::Joined, Client}
 /// hidden from us by the homeserver. This is done to preserve privacy and not
 /// let us know whom the user verified.
 ///
-/// Generally the Master key will be used as a fingerprint to identify an
-/// identity.
+/// The Master key can be used as a fingerprint to present the identity to
+/// users.
 ///
 /// [cross signing]: https://spec.matrix.org/unstable/client-server-api/#cross-signing
 #[derive(Debug, Clone)]
@@ -259,7 +259,7 @@ impl UserIdentity {
     /// ### Manually verifying user identities belonging to us.
     ///
     /// On the other hand, if the user identity belongs to us, it will be
-    /// marked as verified using a flag, our own device will also sign the
+    /// marked as verified using a local flag, our own device will also sign the
     /// Master key. Manually verifying our own user identity can't fail.
     ///
     /// ### Problems of manual verification
diff --git a/crates/matrix-sdk/src/error.rs b/crates/matrix-sdk/src/error.rs
index 56ee0e5ff..090e2c300 100644
--- a/crates/matrix-sdk/src/error.rs
+++ b/crates/matrix-sdk/src/error.rs
@@ -39,7 +39,7 @@ use serde_json::Error as JsonError;
 use thiserror::Error;
 use url::ParseError as UrlParseError;
 
-/// Result type of the rust-sdk.
+/// Result type of the matrix-sdk.
 pub type Result<T> = std::result::Result<T, Error>;
 
 /// Result type of a pure HTTP request.