Improve overloads for quantity scaling by Percentage

Signed-off-by: Leandro Lucarella <[email protected]>

Author: llucax

src/frequenz/sdk/timeseries/_quantities.py

@@ -262,13 +262,13 @@ def __sub__(self, other: Self) -> Self:
         return difference
 
     def __mul__(self, percent: Percentage) -> Self:
-        """Return the product of this quantity and a percentage.
+        """Scale this quantity by a percentage.
 
         Args:
-            percent: The percentage.
+            percent: The percentage by which to scale this quantity.
 
         Returns:
-            The product of this quantity and a percentage.
+            The scaled quantity.
         """
         if not isinstance(percent, Percentage):
             return NotImplemented
@@ -522,10 +522,10 @@ def as_megawatts(self) -> float:
 
     @overload  # type: ignore
     def __mul__(self, other: Percentage) -> Self:
-        """Return a power from multiplying this power by the given percentage.
+        """Scale this power by a percentage.
 
         Args:
-            other: The percentage to multiply by.
+            other: The percentage by which to scale this power.
 
         Returns:
             The scaled power.
@@ -668,10 +668,10 @@ def as_milliamperes(self) -> float:
 
     @overload  # type: ignore
     def __mul__(self, other: Percentage) -> Self:
-        """Return a power from multiplying this power by the given percentage.
+        """Scale this current by a percentage.
 
         Args:
-            other: The percentage to multiply by.
+            other: The percentage by which to scale this current.
 
         Returns:
             The scaled current.
@@ -789,10 +789,10 @@ def as_kilovolts(self) -> float:
 
     @overload  # type: ignore
     def __mul__(self, other: Percentage) -> Self:
-        """Return a power from multiplying this power by the given percentage.
+        """Scale this voltage by a percentage.
 
         Args:
-            other: The percentage to multiply by.
+            other: The percentage by which to scale this voltage.
 
         Returns:
             The scaled voltage.