Auto merge of rust-lang#5330 - matthiaskrgr:newlint_expl, r=flip1995

new_lint.rs: encourage authors to write more detailed code samples in lint descriptions (linted as well as fixed code)

changelog: none

Author: bors

clippy_dev/src/new_lint.rs

@@ -131,7 +131,11 @@ declare_clippy_lint! {{
     /// **Example:**
     ///
     /// ```rust
-    /// // example code
+    /// // example code where clippy issues a warning
+    /// ```
+    /// Use instead:
+    /// ```rust
+    /// // example code which does not raise clippy warning
     /// ```
     pub {name_upper},
     {category},