Suggest make __add__ more explicit.

jklymak · anntzer · commit cf2fe2da2272 · 2020-04-22T23:13:03.000+02:00
... the order of operations is really not clear from the existing doc string.
diff --git a/lib/matplotlib/transforms.py b/lib/matplotlib/transforms.py
@@ -1266,6 +1266,9 @@ def __init_subclass__(cls):
     def __add__(self, other):
         """
         Compose two transforms together so that *self* is followed by *other*.
+
+        ``A + B`` returns a transform ``C`` so that
+        ``C.transform(x) == B.transform(A.transform(x))``.
         """
         return (composite_transform_factory(self, other)
                 if isinstance(other, Transform) else
