From: "Rob Herring (Arm)" <robh@kernel.org>
To: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Cc: Krzysztof Kozlowski <krzk+dt@kernel.org>,
linux-kernel@vger.kernel.org, Conor Dooley <conor+dt@kernel.org>,
devicetree@vger.kernel.org
Subject: Re: [PATCH v2 1/4] docs: dt: submitting-patches: Avoid 'YAML' in the subject and add an example
Date: Mon, 14 Jul 2025 16:22:38 -0500 [thread overview]
Message-ID: <175252814379.3190089.3499993933519513496.robh@kernel.org> (raw)
In-Reply-To: <20250713-dt-bindings-docs-v2-1-672c898054ae@linaro.org>
On Sun, 13 Jul 2025 14:46:36 +0200, Krzysztof Kozlowski wrote:
> Patches adding new device bindings should avoid 'YAML' keyword in the
> subject, because all bindings are supposed to be in DT schema format,
> which uses YAML. The DT schema is welcomed only in case of patches
> doing conversion. Effectively people get confused that subject should
> not contain anything else than device name after the prefix, so add two
> recommended examples.
>
> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
>
> ---
>
> Changes in v2:
> 1. Rephrase - use YAML instead of schema, add another example for
> conversion.
> ---
> Documentation/devicetree/bindings/submitting-patches.rst | 12 ++++++++++--
> 1 file changed, 10 insertions(+), 2 deletions(-)
>
Applied, thanks!
next prev parent reply other threads:[~2025-07-14 21:22 UTC|newest]
Thread overview: 13+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-07-13 12:46 [PATCH v2 0/4] docs: dt: Document established practices: compatible and file naming, subjects Krzysztof Kozlowski
2025-07-13 12:46 ` [PATCH v2 1/4] docs: dt: submitting-patches: Avoid 'YAML' in the subject and add an example Krzysztof Kozlowski
2025-07-14 17:19 ` Conor Dooley
2025-07-14 21:22 ` Rob Herring (Arm) [this message]
2025-07-13 12:46 ` [PATCH v2 2/4] docs: dt: writing-bindings: Document compatible and filename naming Krzysztof Kozlowski
2025-07-14 17:20 ` Conor Dooley
2025-07-14 21:22 ` Rob Herring (Arm)
2025-07-13 12:46 ` [PATCH v2 3/4] docs: dt: writing-bindings: Document discouraged instance IDs Krzysztof Kozlowski
2025-07-14 17:20 ` Conor Dooley
2025-07-14 21:22 ` Rob Herring (Arm)
2025-07-13 12:46 ` [PATCH v2 4/4] docs: dt: writing-schema: Document preferred order of properties Krzysztof Kozlowski
2025-07-14 17:20 ` Conor Dooley
2025-07-14 21:23 ` Rob Herring (Arm)
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=175252814379.3190089.3499993933519513496.robh@kernel.org \
--to=robh@kernel.org \
--cc=conor+dt@kernel.org \
--cc=devicetree@vger.kernel.org \
--cc=krzk+dt@kernel.org \
--cc=krzysztof.kozlowski@linaro.org \
--cc=linux-kernel@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®