diff --git a/clippy_lints/src/use_crate_prefix_for_self_imports.rs b/clippy_lints/src/use_crate_prefix_for_self_imports.rs
index eaa8287fbd00..cf86eb227ac8 100644
--- a/clippy_lints/src/use_crate_prefix_for_self_imports.rs
+++ b/clippy_lints/src/use_crate_prefix_for_self_imports.rs
@@ -20,13 +20,30 @@ declare_clippy_lint! {
     /// This helps reduce confusion and maintain a uniform codebase.
     ///
     /// ### Example
-    /// ```no_run
-    /// use foo::bar; // foo is a module in the current crate
+    /// ```rust,ignore
+    /// // lib.rs
+    /// mod foo;
+    /// use foo::bar;
     /// ```
+    ///
+    /// ```rust,ignore
+    /// // foo.rs
+    /// #[path = "./foo.rs"]
+    /// pub fn bar() {}
+    /// ```
+    ///
     /// Use instead:
-    /// ```no_run
+    /// ```rust,ignore
+    /// // lib.rs
+    /// mod foo;
     /// use crate::foo::bar;
     /// ```
+    ///
+    /// ```rust,ignore
+    /// // foo.rs
+    /// #[path = "./foo.rs"]
+    /// pub fn bar() {}
+    /// ```
     #[clippy::version = "1.84.0"]
     pub USE_CRATE_PREFIX_FOR_SELF_IMPORTS,
     style,