Drop example to private PowerDistributor API

This example is dropped because it's not just outdated but also purely
private. Users shall not use PowerDistributor but access the batteries
through BatteryPool instead.

Signed-off-by: Christian Parpart <[email protected]>

Author: christianparpart

src/frequenz/sdk/actor/power_distributing/power_distributing.py

@@ -107,74 +107,6 @@ class PowerDistributingActor(Actor):
     overlap (they have at least one common battery), then then both batteries
     will be processed. However it is not expected so the proper error log will be
     printed.
-
-    Example:
-        ```python
-        from frequenz.sdk import microgrid
-        from frequenz.sdk.microgrid.component import ComponentCategory
-        from frequenz.sdk.actor import ResamplerConfig
-        from frequenz.sdk.actor.power_distributing import (
-            PowerDistributingActor,
-            Request,
-            Result,
-            Success,
-            Error,
-            PartialFailure,
-            Ignored,
-        )
-        from frequenz.channels import Broadcast, Receiver, Sender
-        from datetime import timedelta
-
-        HOST = "localhost"
-        PORT = 50051
-
-        await microgrid.initialize(
-            HOST,
-            PORT,
-            ResamplerConfig(resampling_period=timedelta(seconds=1))
-        )
-
-        graph = microgrid.connection_manager.get().component_graph
-
-        batteries = graph.components(component_category={ComponentCategory.BATTERY})
-        batteries_ids = {c.component_id for c in batteries}
-
-        battery_status_channel = Broadcast[BatteryStatus]("battery-status")
-
-        channel = Broadcast[Request]("power_distributor")
-        channel_registry = ChannelRegistry(name="power_distributor")
-        async with PowerDistributingActor(
-            requests_receiver=channel.new_receiver(),
-            channel_registry=channel_registry,
-            battery_status_sender=battery_status_channel.new_sender(),
-        ):
-            sender = channel.new_sender()
-            namespace: str = "namespace"
-            # Set power 1200W to given batteries.
-            request = Request(
-                namespace=namespace,
-                power=1200.0,
-                batteries=batteries_ids,
-                request_timeout_sec=10.0
-            )
-            await sender.send(request)
-            result_rx = channel_registry.new_receiver(namespace)
-
-            # It is recommended to use timeout when waiting for the response!
-            result: Result = await asyncio.wait_for(result_rx.receive(), timeout=10)
-
-            if isinstance(result, Success):
-                print("Command succeed")
-            elif isinstance(result, PartialFailure):
-                print(
-                    f"Batteries {result.failed_batteries} failed, total failed power" \
-                    f"{result.failed_power}"
-                )
-            elif isinstance(result, Ignored):
-                print("Request was ignored, because of newer request")
-            elif isinstance(result, Error):
-                print(f"Request failed with error: {result.msg}")
-        ```
     """
 
     def __init__(