[return-arg-in-generator] Add a details.rst only as the message is not raised anymore

doc/data/messages/r/return-arg-in-generator/details.rst

@@ -0,0 +1,16 @@
+This is a message that isn't going to be raised for python > 3.3. It was raised
+for code like::
+
+    def interrogate_until_you_find_jack(pirates):
+        for pirate in pirates:
+            if pirate == "Captain Jack Sparrow":
+                return "Arrr! We've found our captain!"
+            yield pirate
+
+Which is now valid and equivalent to the previously expected::
+
+    def interrogate_until_you_find_jack(pirates):
+        for pirate in pirates:
+            if pirate == "Captain Jack Sparrow":
+                raise StopIteration("Arrr! We've found our captain!")
+            yield pirate

doc/data/messages/r/return-arg-in-generator/related.rst

@@ -0,0 +1,2 @@
+- `PEP380 <https://peps.python.org/pep-0380/>`_
+- `Stackoverflow explanation <https://stackoverflow.com/a/16780113/2519059>`_

doc/user_guide/checkers/features.rst

@@ -81,9 +81,9 @@ Basic checker Messages
 :return-outside-function (E0104): *Return outside function*
   Used when a "return" statement is found outside a function or method.
 :return-arg-in-generator (E0106): *Return with argument inside generator*
-  Used when a "return" statement with an argument is found outside in a
-  generator function or method (e.g. with some "yield" statements). This
-  message can't be emitted when using Python >= 3.3.
+  Used when a "return" statement with an argument is found in a generator
+  function or method (e.g. with some "yield" statements). This message can't be
+  emitted when using Python >= 3.3.
 :invalid-star-assignment-target (E0113): *Starred assignment target must be in a list or tuple*
   Emitted when a star expression is used as a starred assignment target.
 :bad-reversed-sequence (E0111): *The first reversed() argument is not a sequence*

pylint/checkers/base/basic_error_checker.py

@@ -135,8 +135,7 @@ class BasicErrorChecker(_BasicChecker):
             "Return with argument inside generator",
             "return-arg-in-generator",
             'Used when a "return" statement with an argument is found '
-            "outside in a generator function or method (e.g. with some "
-            '"yield" statements).',
+            'in a generator function or method (e.g. with some "yield" statements).',
             {"maxversion": (3, 3)},
         ),
         "E0107": (