Improve docstring of EntityComponent and EntityPlatform (#128135)

Author: emontnemery

homeassistant/helpers/entity_component.py

@@ -65,10 +65,13 @@ async def async_update_entity(hass: HomeAssistant, entity_id: str) -> None:
 
 
 class EntityComponent(Generic[_EntityT]):
-    """The EntityComponent manages platforms that manages entities.
+    """The EntityComponent manages platforms that manage entities.
+
+    An example of an entity component is 'light', which manages platforms such
+    as 'hue.light'.
 
     This class has the following responsibilities:
-     - Process the configuration and set up a platform based component.
+     - Process the configuration and set up a platform based component, for example light.
      - Manage the platforms and their entities.
      - Help extract the entities from a service call.
      - Listen for discovery events for platforms related to the domain.

homeassistant/helpers/entity_platform.py

@@ -111,7 +111,11 @@ async def async_setup_entry(
 
 
 class EntityPlatform:
-    """Manage the entities for a single platform."""
+    """Manage the entities for a single platform.
+
+    An example of an entity platform is 'hue.light', which is managed by
+    the entity component 'light'.
+    """
 
     def __init__(
         self,