diff --git a/clippy_lints/src/methods/mod.rs b/clippy_lints/src/methods/mod.rs
index 11ed1e70e388e..6d22abf2d3397 100644
--- a/clippy_lints/src/methods/mod.rs
+++ b/clippy_lints/src/methods/mod.rs
@@ -452,7 +452,8 @@ declare_clippy_lint! {
 /// **Why is this bad?** As a convention, `new` methods are used to make a new
 /// instance of a type.
 ///
-/// **Known problems:** None.
+/// **Known problems:** The lint fires when the return type is wrapping `Self`.
+/// Example: `fn new() -> Result<Self, E> {}`
 ///
 /// **Example:**
 /// ```rust
diff --git a/clippy_lints/src/ptr_offset_with_cast.rs b/clippy_lints/src/ptr_offset_with_cast.rs
index 38a9bbf6d4c40..58afdc351d199 100644
--- a/clippy_lints/src/ptr_offset_with_cast.rs
+++ b/clippy_lints/src/ptr_offset_with_cast.rs
@@ -41,7 +41,7 @@ use std::fmt;
 declare_clippy_lint! {
     pub PTR_OFFSET_WITH_CAST,
     complexity,
-    "uneeded pointer offset cast"
+    "unneeded pointer offset cast"
 }
 
 #[derive(Copy, Clone, Debug)]