Added use-a-generator message example

doc/data/messages/u/use-a-generator/bad.py

@@ -0,0 +1,4 @@
+from random import randint
+
+all([randint(-5, 5) > 0 for _ in range(10)])  # [use-a-generator]
+any([randint(-5, 5) > 0 for _ in range(10)])  # [use-a-generator]

doc/data/messages/u/use-a-generator/details.rst

@@ -0,0 +1,3 @@
+By using a generator you can cut the execution tree and exit directly at the first element that is ``False`` for ``all`` or ``True`` for ``any`` instead of
+calculating all the elements. Except in the worst possible case where you still need to evaluate everything (all values
+are True for ``all`` or all values are false for ``any``) performance will be better.

doc/data/messages/u/use-a-generator/good.py

@@ -0,0 +1,4 @@
+from random import randint
+
+all(randint(-5, 5) > 0 for _ in range(10))
+any(randint(-5, 5) > 0 for _ in range(10))

doc/data/messages/u/use-a-generator/related.rst

@@ -0,0 +1,2 @@
+- `PEP 289 – Generator Expressions <https://peps.python.org/pep-0289/>`_
+- `Benchmark and discussion during initial implementation <https://github.com/PyCQA/pylint/pull/3309#discussion_r576683109>`_