Added comparison-with-callable message example (#6156)

Co-authored-by: Vladyslav Krylasov <[email protected]>
Co-authored-by: Pierre Sassoulas <[email protected]>

Author: 3 people

doc/data/messages/c/comparison-with-callable/bad.py

@@ -0,0 +1,6 @@
+def function_returning_a_fruit() -> str:
+    return "orange"
+
+def is_an_orange(fruit: str = "apple"):
+    # apple == <function function_returning_a_fruit at 0x7f343ff0a1f0>
+    return fruit == function_returning_a_fruit  # [comparison-with-callable]

doc/data/messages/c/comparison-with-callable/good.py

@@ -0,0 +1,6 @@
+def function_returning_a_fruit() -> str:
+    return "orange"
+
+def is_an_orange(fruit: str = "apple"):
+    # apple == orange
+    return fruit == function_returning_a_fruit()