Amend data pipeline methods documentation

Amend data pipeline methods documentation to be more
concise on what it is helpful for the user.

Signed-off-by: Daniel Zullo <[email protected]>

Author: daniel-zullo-frequenz

src/frequenz/sdk/microgrid/_data_pipeline.py

@@ -129,11 +129,7 @@ def __init__(
         self._voltage_instance: VoltageStreamer | None = None
 
     def frequency(self) -> GridFrequency:
-        """Fetch the grid frequency for the microgrid.
-
-        Returns:
-            The GridFrequency instance.
-        """
+        """Return the grid frequency measuring point."""
         if self._frequency_instance is None:
             self._frequency_instance = GridFrequency(
                 self._data_sourcing_request_sender(),
@@ -143,11 +139,7 @@ def frequency(self) -> GridFrequency:
         return self._frequency_instance
 
     def voltage(self) -> VoltageStreamer:
-        """Fetch the 3-phase voltage for the microgrid.
-
-        Returns:
-            The VoltageStreamer instance.
-        """
+        """Return the 3-phase voltage measuring point."""
         if not self._voltage_instance:
             self._voltage_instance = VoltageStreamer(
                 self._resampling_request_sender(),
@@ -157,13 +149,7 @@ def voltage(self) -> VoltageStreamer:
         return self._voltage_instance
 
     def logical_meter(self) -> LogicalMeter:
-        """Return the logical meter instance.
-
-        If a LogicalMeter instance doesn't exist, a new one is created and returned.
-
-        Returns:
-            A logical meter instance.
-        """
+        """Return the logical meter of the microgrid."""
         from ..timeseries.logical_meter import LogicalMeter
 
         if self._logical_meter is None:
@@ -174,13 +160,7 @@ def logical_meter(self) -> LogicalMeter:
         return self._logical_meter
 
     def consumer(self) -> Consumer:
-        """Return the consumer instance.
-
-        If a Consumer instance doesn't exist, a new one is created and returned.
-
-        Returns:
-            A Consumer instance.
-        """
+        """Return the consumption measuring point of the microgrid."""
         from ..timeseries.consumer import Consumer
 
         if self._consumer is None:
@@ -191,13 +171,7 @@ def consumer(self) -> Consumer:
         return self._consumer
 
     def producer(self) -> Producer:
-        """Return the producer instance.
-
-        If a Producer instance doesn't exist, a new one is created and returned.
-
-        Returns:
-            A Producer instance.
-        """
+        """Return the production measuring point of the microgrid."""
         from ..timeseries.producer import Producer
 
         if self._producer is None:
@@ -239,13 +213,7 @@ def ev_charger_pool(
         return self._ev_charger_pools[key]
 
     def grid(self) -> Grid:
-        """Return the grid instance.
-
-        If a Grid instance doesn't exist, a new one is created and returned.
-
-        Returns:
-            A Grid instance.
-        """
+        """Return the grid measuring point."""
         if self._grid is None:
             initialize_grid(
                 channel_registry=self._channel_registry,
@@ -457,31 +425,17 @@ async def initialize(resampler_config: ResamplerConfig) -> None:
 
 
 def frequency() -> GridFrequency:
-    """Return the grid frequency.
-
-    Returns:
-        The grid frequency.
-    """
+    """Return the grid frequency measuring point."""
     return _get().frequency()
 
 
 def voltage() -> VoltageStreamer:
-    """Return the 3-phase voltage for the microgrid.
-
-    Returns:
-        The 3-phase voltage.
-    """
+    """Return the 3-phase voltage measuring point."""
     return _get().voltage()
 
 
 def logical_meter() -> LogicalMeter:
-    """Return the logical meter instance.
-
-    If a LogicalMeter instance doesn't exist, a new one is created and returned.
-
-    Returns:
-        A logical meter instance.
-    """
+    """Return the logical meter of the microgrid."""
     return _get().logical_meter()
 
 
@@ -540,11 +494,7 @@ def battery_pool(
 
 
 def grid() -> Grid:
-    """Return the grid instance.
-
-    Returns:
-        The Grid instance.
-    """
+    """Return the grid measuring point."""
     return _get().grid()