Re: [PATCH] docs: dt: writing-schema: Extend expectations about example part of binding

[Krzysztof Kozlowski]

On 21/07/2026 17:44, Conor Dooley wrote:
>>
>> diff --git a/Documentation/devicetree/bindings/writing-schema.rst b/Documentation/devicetree/bindings/writing-schema.rst
>> index 3ffd0828617a..0f665b13c126 100644
>> --- a/Documentation/devicetree/bindings/writing-schema.rst
>> +++ b/Documentation/devicetree/bindings/writing-schema.rst
>> @@ -127,9 +127,16 @@ additionalProperties / unevaluatedProperties
>>          two above cases ('false').
>>  
>>  examples
>> -  Optional. A list of one or more DTS hunks implementing this binding only.
>> -  Example should not contain unrelated device nodes, e.g. consumer nodes in a
>> -  provider binding, other nodes referenced by phandle.
>> +  Optional, although expected in every device binding. A list of one or more
> 
> I think this first sentence doesn't really get across the "final device"
> point you were going for. I think it should probably say something like
> "although expected outside of bindings describing common properties or
> sub-blocks of more complex devices." I think being clear only benefits
> us here.

Ack

Best regards,
Krzysztof