[M4E] Add id requirement (#4386)

esphome · Oct 24, 2024 · 43029f7 · 43029f7
1 parent 5aad41d
commit 43029f7
Show file tree

Hide file tree

Showing 2 changed files with 7 additions and 0 deletions.
diff --git a/components/packages.rst b/components/packages.rst
@@ -142,6 +142,8 @@ As an example, if the configuration needed to support three garage doors using t
         platform: gpio
         # ...
 
+.. _config-packages_extend:
+
 Extend
 ------
 
@@ -169,6 +171,8 @@ For example, to set a specific update interval on a common uptime sensor that is
       - id: !extend uptime_sensor
         update_interval: 10s
 
+.. _config-packages_remove:
+
 Remove
 ------
 

diff --git a/guides/made_for_esphome.rst b/guides/made_for_esphome.rst
@@ -34,6 +34,9 @@ For all projects
 - Your project is powered by an ESP32 or *supported* ESP32 variant such as the S2, S3, C3, etc.
 - Your ESPHome configuration is open source, available for end users to modify/update
 - Users should be able to apply updates if your project sells ready-made devices
+- All components/platforms used must have an ``id`` specified so users can easily refer to,
+  :ref:`config-packages_extend` and/or :ref:`config-packages_remove` configuration variables should they choose to
+  "take control"
 - Your project supports adoption via the ``dashboard_import`` feature of ESPHome (see
   :doc:`Sharing </guides/creators>`). In particular: