[Doc] Improving implicit-str-concat/details.rst (#8649)

Co-authored-by: Pierre Sassoulas <pierre.sassoulas@gmail.com>

2 files changed, 13 insertions, 1 deletions

diff --git a/doc/data/messages/i/implicit-str-concat/details.rst b/doc/data/messages/i/implicit-str-concat/details.rst
index c1e136183..f09d48110 100644
--- a/doc/data/messages/i/implicit-str-concat/details.rst
+++ b/doc/data/messages/i/implicit-str-concat/details.rst
@@ -1,6 +1,5 @@
 By default, detection of implicit string concatenation of line jumps is disabled.
 Hence the following code will not trigger this rule:
-Hence the following code will not trigger this rule:
 
 .. code-block:: python
 
@@ -13,3 +12,15 @@ In order to detect this case, you must enable `check-str-concat-over-line-jumps`
 
     [STRING_CONSTANT]
     check-str-concat-over-line-jumps = yes
+
+However, the drawback of this setting is that it will trigger false positive
+for string parameters passed on multiple lines in function calls:
+
+.. code-block:: python
+
+    warnings.warn(
+        "rotate() is deprecated and will be removed in a future release. "
+        "Use the rotation() context manager instead.",
+        DeprecationWarning,
+        stacklevel=3,
+    )
diff --git a/doc/data/messages/i/implicit-str-concat/related.rst b/doc/data/messages/i/implicit-str-concat/related.rst
new file mode 100644
index 000000000..90d29dbdf
--- /dev/null
+++ b/doc/data/messages/i/implicit-str-concat/related.rst
@@ -0,0 +1 @@
+- `Allowing parenthesized implicitly concatenated strings, to be more compatible with black <https://github.com/pylint-dev/pylint/pull/8590>`_