diff --git a/homeassistant/config_entries.py b/homeassistant/config_entries.py
index cc8f3d1dd0965..12c8640118e53 100644
--- a/homeassistant/config_entries.py
+++ b/homeassistant/config_entries.py
@@ -1482,8 +1482,12 @@ async def async_finish_flow(
             )
 
         if existing_entry is not None and flow.handler != "mobile_app":
-            # This causes the old entry to be removed and replaced when it
-            # should most likely update the previous entry and abort the flow
+            # This causes the old entry to be removed and replaced, when the flow
+            # should instead be aborted.
+            # In case of manual flows, integrations should implement options, reauth,
+            # reconfigure to allow the user to change settings.
+            # In case of non user visible flows, the integration should optionally
+            # update the existing entry before aborting.
             # see https://developers.home-assistant.io/blog/2024/11/22/config-flow-unique-id/
             report_usage(
                 "creates a config entry when another entry with the same unique ID "