Re: [PATCH] docs: dt: writing-bindings: Document node name ABI and simple-mfd

[Rob Herring (Arm)]

On Mon, 18 Aug 2025 15:25:35 +0200, Krzysztof Kozlowski wrote:
> Document established Devicetree bindings maintainers review practice:
> 
> 1. Device node names should not be treated as an ABI, unless for
>    children of a device when documented.
>    There were many patches posted using of_find_node_by_name() or
>    of_node_name_eq() for accessing siblings or completely different
>    nodes.  These cases were introducing undocumented ABI, so they are
>    discouraged.
> 
> 2. 'simple-mfd' means children do not depend on parent device resources.
>    'simple-bus' is so simple, that even 'reg' properties are not
>    applicable.
> 
> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@xxxxxxxxxx>
> ---
>  Documentation/devicetree/bindings/writing-bindings.rst | 9 +++++++++
>  1 file changed, 9 insertions(+)
> 

Applied, thanks!