[PATCH v2 4/4] docs: dt: writing-schema: Document preferred order of properties

Krzysztof Kozlowski posted 4 patches 2 months, 3 weeks ago
[PATCH v2 4/4] docs: dt: writing-schema: Document preferred order of properties
Posted by Krzysztof Kozlowski 2 months, 3 weeks ago
Document established Devicetree bindings maintainers review practice:
using DTS coding style property order in both 'properties' and
'required' secions.

Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>

---

Changes in v2:
1. New patch
---
 Documentation/devicetree/bindings/writing-schema.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/Documentation/devicetree/bindings/writing-schema.rst b/Documentation/devicetree/bindings/writing-schema.rst
index fc73072f12fc58dbaf3dea3eb8cc79cfac0341c8..470d1521fa174f4fac29004b95a9b1a8c37071d9 100644
--- a/Documentation/devicetree/bindings/writing-schema.rst
+++ b/Documentation/devicetree/bindings/writing-schema.rst
@@ -171,6 +171,9 @@ Coding style
 Use YAML coding style (two-space indentation). For DTS examples in the schema,
 preferred is four-space indentation.
 
+Place entries in 'properties' and 'required' sections in the same order, using
+style from Documentation/devicetree/bindings/dts-coding-style.rst.
+
 Testing
 -------
 

-- 
2.43.0
Re: [PATCH v2 4/4] docs: dt: writing-schema: Document preferred order of properties
Posted by Rob Herring (Arm) 2 months, 3 weeks ago
On Sun, 13 Jul 2025 14:46:39 +0200, Krzysztof Kozlowski wrote:
> Document established Devicetree bindings maintainers review practice:
> using DTS coding style property order in both 'properties' and
> 'required' secions.
> 
> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
> 
> ---
> 
> Changes in v2:
> 1. New patch
> ---
>  Documentation/devicetree/bindings/writing-schema.rst | 3 +++
>  1 file changed, 3 insertions(+)
> 

Applied, thanks!
Re: [PATCH v2 4/4] docs: dt: writing-schema: Document preferred order of properties
Posted by Conor Dooley 2 months, 3 weeks ago
On Sun, Jul 13, 2025 at 02:46:39PM +0200, Krzysztof Kozlowski wrote:
> Document established Devicetree bindings maintainers review practice:
> using DTS coding style property order in both 'properties' and
> 'required' secions.
> 
> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>

Reviewed-by: Conor Dooley <conor.dooley@microchip.com>