diff --git a/python/damask/_config.py b/python/damask/_config.py
index 06ac13894..5423699db 100644
--- a/python/damask/_config.py
+++ b/python/damask/_config.py
@@ -120,7 +120,7 @@ class Config(dict):
         """
         Return self|=other.
 
-        Update configuration with contents of other.
+        Update configuration with contents of other (in-place).
 
         """
         return self.__or__(other)
diff --git a/python/damask/_orientation.py b/python/damask/_orientation.py
index f60772901..8bbcb7957 100644
--- a/python/damask/_orientation.py
+++ b/python/damask/_orientation.py
@@ -246,11 +246,13 @@ class Orientation(Rotation,Crystal):
     def __mul__(self: MyType,
                 other: Union[Rotation, 'Orientation']) -> MyType:
         """
-        Compose this orientation with other.
+        Return self*other.
+
+        Compose with other.
 
         Parameters
         ----------
-        other : Rotation or Orientation
+        other : Rotation or Orientation, shape (self.shape)
             Object for composition.
 
         Returns