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

From: Rob Herring (Arm)

Date: Wed Jul 22 2026 - 19:25:09 EST



On Wed, 22 Jul 2026 08:22:41 +0200, Krzysztof Kozlowski wrote:
> Document already used rules about example DTS in the binding:
>
> - All final device bindings (except sub-block of more complex devices)
> should have an example.
>
> - Phandles do not need to be resolvable - Sashiko already provided
> incorrect review, so this might help it to understand the concept.
>
> - Example should be complete, readable (use known defines), without
> 'status' property.
>
> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@xxxxxxxxxxxxxxxx>
>
> ---
>
> Changes in v2:
> 1. Rewrite "optional" exception, as Conor suggested.
> 2. "normal" -> "typical" in last sentence about status.
> ---
> .../devicetree/bindings/writing-schema.rst | 13 ++++++++++---
> 1 file changed, 10 insertions(+), 3 deletions(-)
>

Applied, thanks!