Update comment

Author: epenet

homeassistant/config_entries.py

@@ -1487,8 +1487,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 "