Add note about caveat for cfg(doc) (#13724)

For example, we definitely wouldn't want to do this in libcore.

changelog: none

Author: Alexendoo

clippy_lints/src/doc/mod.rs

@@ -539,11 +539,17 @@ declare_clippy_lint! {
     /// ### What it does
     /// Checks if included files in doc comments are included only for `cfg(doc)`.
     ///
-    /// ### Why is this bad?
+    /// ### Why restrict this?
     /// These files are not useful for compilation but will still be included.
     /// Also, if any of these non-source code file is updated, it will trigger a
     /// recompilation.
     ///
+    /// ### Known problems
+    ///
+    /// Excluding this will currently result in the file being left out if
+    /// the item's docs are inlined from another crate. This may be fixed in a
+    /// future version of rustdoc.
+    ///
     /// ### Example
     /// ```ignore
     /// #![doc = include_str!("some_file.md")]
@@ -554,7 +560,7 @@ declare_clippy_lint! {
     /// ```
     #[clippy::version = "1.84.0"]
     pub DOC_INCLUDE_WITHOUT_CFG,
-    pedantic,
+    restriction,
     "check if files included in documentation are behind `cfg(doc)`"
 }