Documentation/process/maintainer-soc.rst

80    Devicetree bindings.  The MAINTAINERS file entry should list new
95 Devicetree ABI Stability
99 document the ABI between the devicetree and the kernel.
100 Please read Documentation/devicetree/bindings/ABI.rst.
112 A common problem is synchronizing changes between device drivers and devicetree
117 corresponding change to the devicetree binding description, to ensure they are
118 in fact compatible.  This means that the devicetree branch can end up causing
119 warnings in the ``make dtbs_check`` step.  If a devicetree change depends on
129 * Use literal values in the devicetree file in place of macros even when a
133 * Defer the devicetree changes to a release after the binding and driver have
137   both the driver change and the devicetree changes
139 * Add duplicate defines in the devicetree file guarded by an #ifndef section,
142 Devicetree Naming Convention
145 The general naming scheme for devicetree files is as follows.  The aspects of a
161 Validating Devicetree Files
164 ``make dtbs_check`` can be used to validate that devicetree files are compliant
166 "Running checks" of Documentation/devicetree/bindings/writing-schema.rst for
172 If in any doubt about a devicetree change, reach out to the devicetree
179 submaintainers will do the same. Driver, defconfig and devicetree changes should
193 SoC tree.  An example here would be one branch for devicetree warning fixes, one