[PATCH v2 1/3] docs: dt: writing-bindings: Rephrase typical fallback (superset) usage
From: Krzysztof Kozlowski
Date: Mon Jul 07 2025 - 05:52:15 EST
When speaking about compatibles for new devices comparing to "prior
implementations", usually we expect new device to come with more
features, thus logically it is a superset, not subset, of "prior
implementations".
Suggested-by: Conor Dooley <conor@xxxxxxxxxx>
Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@xxxxxxxxxx>
---
Changes in v2:
1. New patch, superset suggested by Conor.
---
Documentation/devicetree/bindings/writing-bindings.rst | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/Documentation/devicetree/bindings/writing-bindings.rst b/Documentation/devicetree/bindings/writing-bindings.rst
index 1ad081de2dd0..66c94b5adc87 100644
--- a/Documentation/devicetree/bindings/writing-bindings.rst
+++ b/Documentation/devicetree/bindings/writing-bindings.rst
@@ -40,9 +40,9 @@ Properties
==========
- DO make 'compatible' properties specific. DON'T use wildcards in compatible
- strings. DO use fallback compatibles when devices are the same as or a subset
- of prior implementations. DO add new compatibles in case there are new
- features or bugs.
+ strings. DO use fallback compatibles when devices are the same as or a
+ superset of prior implementations. DO add new compatibles in case there are
+ new features or bugs.
- DO use a vendor prefix on device-specific property names. Consider if
properties could be common among devices of the same class. Check other
--
2.43.0