docs: dt-bindings: Extend the ordering list with a blank newline before status

For better readability, it is recommended to insert a newline before the
'status' property. Adjust the examples accordingly.

Signed-off-by: David Heidelberg <david@ixit.cz>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://patch.msgid.link/20251023-docs-dt-newline-v1-1-1bf5e0040c0b@ixit.cz
Signed-off-by: Rob Herring (Arm) <robh@kernel.org>

diff --git a/Documentation/devicetree/bindings/dts-coding-style.rst b/Documentation/devicetree/bindings/dts-coding-style.rst
index 202acac0507ab113c0d56c0be1421d3f5c3305e0..4a02ea60cbbe2745049483a1546d90899f2082ed 100644 (file)
--- a/Documentation/devicetree/bindings/dts-coding-style.rst
+++ b/Documentation/devicetree/bindings/dts-coding-style.rst
@@ -120,7 +120,8 @@ The following order of properties in device nodes is preferred:
 4. Standard/common properties (defined by common bindings, e.g. without
    vendor-prefixes)
 5. Vendor-specific properties
-6. "status" (if applicable)
+6. "status" (if applicable), preceded by a blank line if there is content
+   before the property
 7. Child nodes, where each node is preceded with a blank line
 
 The "status" property is by default "okay", thus it can be omitted.
@@ -150,6 +151,7 @@ Example::
                #address-cells = <1>;
                #size-cells = <1>;
                vendor,custom-property = <2>;
+
                status = "disabled";
 
                child_node: child-class@100 {
@@ -165,6 +167,7 @@ Example::
                vdd-1v8-supply = <&board_vreg4>;
                vdd-3v3-supply = <&board_vreg2>;
                vdd-12v-supply = <&board_vreg3>;
+
                status = "okay";
        }