Add example for bad-super-call (#6166)

Co-authored by: Vladyslav Krylasov <vladyslav.krylasov@gmail.com>
Co-authored-by: Jacob Walls <jacobtylerwalls@gmail.com>
Co-authored-by: Pierre Sassoulas <pierre.sassoulas@gmail.com>

Author: 3 people

doc/data/messages/b/bad-super-call/bad.py

@@ -0,0 +1,7 @@
+class Animal:
+    pass
+
+
+class Cat(Animal):
+    def __init__(self):
+        super(Animal, self).__init__()  # [bad-super-call]

doc/data/messages/b/bad-super-call/details.rst

@@ -0,0 +1,4 @@
+In Python 2.7, ``super()`` has to be called with its own class and ``self`` as arguments (``super(Cat, self)``), which can
+lead to a mix up of parent and child class in the code.
+
+In Python 3 the recommended way is to call ``super()`` without arguments (see also ``super-with-arguments``).

doc/data/messages/b/bad-super-call/good.py

@@ -0,0 +1,7 @@
+class Animal:
+    pass
+
+
+class Cat(Animal):
+    def __init__(self):
+        super().__init__()

doc/data/messages/b/bad-super-call/related.rst

@@ -0,0 +1 @@
+- `Documentation for super() <https://docs.python.org/3/library/functions.html#super>`_