From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wm1-f48.google.com (mail-wm1-f48.google.com [209.85.128.48]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 03B2AF9D6 for ; Sun, 13 Jul 2025 12:46:46 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.48 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1752410810; cv=none; b=ZGbIYJN3sFdRiU5atVT+alVR36GCE4O/u94pmdJ9ZmKwcS4pImfcfVx7gggB8Ut83sY73Y493dQofK5PcImat6X9+/I7VviQXVk3ivpOc3cNz92c3CoerWrrQ0739yfjlsqg096NUN6rQfSwY3LCfvp4IweofIaLzYeGYdPHy3s= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1752410810; c=relaxed/simple; bh=CTLQ1hf8YF/BxJ03zAJvfKWuzlRvoivCAalOztiHMkY=; h=From:Subject:Date:Message-Id:MIME-Version:Content-Type:To:Cc; b=uV9Ga4siApBhRR4nZhbE7oSnBXOWQXEbTzBpHOJafya0GB6/neMlMxOQ82By+5Lfo09D6njRugWdy/ISlxb1HsGbZtjbFASDQDgax6KhcrDgrvuG1H09yGCQhw/xPrliM4w0uit7ofv+yipIhv8hbAxvhE6E0K01c8HcSOEtPT4= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linaro.org; spf=pass smtp.mailfrom=linaro.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b=WBuaHjNm; arc=none smtp.client-ip=209.85.128.48 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linaro.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linaro.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b="WBuaHjNm" Received: by mail-wm1-f48.google.com with SMTP id 5b1f17b1804b1-456053b5b8cso650995e9.3 for ; Sun, 13 Jul 2025 05:46:46 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1752410805; x=1753015605; darn=vger.kernel.org; h=cc:to:content-transfer-encoding:mime-version:message-id:date :subject:from:from:to:cc:subject:date:message-id:reply-to; bh=NNz1F+rRHg2OHfi6CTNAI0f/wy5uxaLTWsJ5ep29OW8=; b=WBuaHjNmsR4l1tBV+dE5EAjkCdyv6wXOv1O55CIYG2Xe+lAqWO3bBhX4lWmvjl0E6y U6JMoKf+W3wa9RpquC7QHxDT1vItobk+HFQY4joSdpiBjGRVFYq4nZt1wXxb9Yxr914o 2WL+h/l/TXBZUXEpTmnpqefkRT4LSe2MFmNj3baorMsYzQqA1ntfLTziGVLqwc/LY0L7 vBfp369pbZMNA6CSLD81YuJUBnl+7TvIrnAYkVhfTMIKWUHRcOJRbS+izfutHU6AOS7+ PS+esv9u9TpzcM/Mtyio50HryKDScIk16KtpC5UdVHkPa3X4AL5IKtiyb6hvm8TsUKUQ 8hsw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1752410805; x=1753015605; h=cc:to:content-transfer-encoding:mime-version:message-id:date :subject:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=NNz1F+rRHg2OHfi6CTNAI0f/wy5uxaLTWsJ5ep29OW8=; b=CLDfy1FpPJsl/T59iBt7cBNy7Zhh78uqFtlJb23JcuwnGS28yMOujVfdnNXfQHM3Qt 3vyUYKe++747iLhkJlmAMSQo6lM9HbmbKL1gGqKHcOJ3RIdSWs6mbOJmJbUFEfHHOhWW jXnAO82fQiILML78eKLnLnTmfn8yQRUCAo+xoFoLVPV6lM3uE7HoW5NrSeNymeOidixP Ne+ftBhLk2vGo76cbQlLlhXcwn1WsJi9pRCH2n6Mw7+TTYacuPmu99tacWUSUu0IPE6k weidN1vkkPIvZuXGOK8QvKbnjbQH2o69ijqDWrEAKxjPYMPvy3SRN0Z67A1gOE0FNQEx aWDg== X-Forwarded-Encrypted: i=1; AJvYcCUnRAf1nxgFwYt7Tytl1l6MSOrwt0Ed0ywntbAGXKGfZNR9Rxapei20uwWegHaREWqMdo7+63Wmln2zDow=@vger.kernel.org X-Gm-Message-State: AOJu0Ywt9VSGnHlfmWIQXXDpRnbGUY+ds2YAJmLFv2jDDCFNLHBltYfA vY/8U44QCQdjKYsw4uiEXigsEJfBE9jrbDXTG6Af/uFN9qJRpp1jAo/ikmVdFWJQa7k= X-Gm-Gg: ASbGnctxgVxhbd3s73v0/HYJ5041K2MROMaOYJOmqpr4gnW7B4srvCWX/rmWiqjTdx6 L6XA6aCCPRLWNacyrHSk9SE2n2Dm340X1VYKAIHivaqGrDYh+e5wslsqMv00W+fHI6w19HUGp5N D8KfwTfDX0VekMgpt0siCU12uXVz7gm4gqJ0F4ZAzRhsn4zQKS+ZxURtBPGJIpxnnfR3fhtAeBg Nxk6ciEGTi6jyQmDY/QxDcn6jJKZ5cZaGSbfocgVBLpODwhYsUqSEJC9X9Md/RyRLh9Drk879Ff A3MdRw2PCacJnYJn5Yuis/fisnpJHldJCabHEbQMeqoI1BSshp+rnhn6TiwiGRnQi8iwj8SSFuu GDua1NOiMhGo2WVOk8YCbnYkfXinKDKnIWaGn X-Google-Smtp-Source: AGHT+IGKxdR63CRDBNOLZ+xnH+bV9+GQzIi23h84ybE2zHN3tNa9bDvkPvWDqkGPtM5fd2DFwY7ztQ== X-Received: by 2002:a05:600c:8b21:b0:439:9a40:aa27 with SMTP id 5b1f17b1804b1-454f4283cdcmr32693535e9.5.1752410805244; Sun, 13 Jul 2025 05:46:45 -0700 (PDT) Received: from [127.0.1.1] ([178.197.222.89]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-3b5e8e14d07sm9828835f8f.66.2025.07.13.05.46.44 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 13 Jul 2025 05:46:44 -0700 (PDT) From: Krzysztof Kozlowski Subject: [PATCH v2 0/4] docs: dt: Document established practices: compatible and file naming, subjects Date: Sun, 13 Jul 2025 14:46:35 +0200 Message-Id: <20250713-dt-bindings-docs-v2-0-672c898054ae@linaro.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit X-B4-Tracking: v=1; b=H4sIAKuqc2gC/x3MMQqAMAxA0atIZgO1olKvIg7VxJqlSiMiFO9uc XzD/xmUk7DCWGVIfIvKEQtsXcG6+xgYhYrBGtuZoWmRLlwkksSgSMeq6B211hjX9c5Byc7Emzz /cprf9wP6aSikYgAAAA== X-Change-ID: 20250713-dt-bindings-docs-a9d320095699 To: Rob Herring , Krzysztof Kozlowski , Conor Dooley Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Krzysztof Kozlowski X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1084; i=krzysztof.kozlowski@linaro.org; h=from:subject:message-id; bh=CTLQ1hf8YF/BxJ03zAJvfKWuzlRvoivCAalOztiHMkY=; b=owEBbQKS/ZANAwAKAcE3ZuaGi4PXAcsmYgBoc6qtRczrxmk7FN9BemQXR3F7i5zodTfOPGSnB NAPp1gz7PWJAjMEAAEKAB0WIQTd0mIoPREbIztuuKjBN2bmhouD1wUCaHOqrQAKCRDBN2bmhouD 1+tED/98FkNTiUjhfK7J4n1bssiiTRX2rBLPxRnm/aGb7kiXR4lgM8S844Njt+4MSwSQwm4RbYl hK56HfNQtDda1mxF1Hv47QwHUVLzCdrCJAomp7e/Din2CJieMeHNLvlP4nXLj/kHoGNjsK19JM0 gIJZLrbpzhc/7EvJvFclkiLpTJD0Cv9qD1JwQgpkYHNi610/+tJkP7kwCYPhz+JBHWJGmp/lieR 1pCRvpQechQ6RA/jrywcpTFZi0RcJIDH1iVQeeh2IAdF83Z6wewzvdMxg/w2fh8vjdll48QQC3j 6yxE1HkQogGEQHsoZUG0b/7vgEBkcl3ox2sAqp1wmy03ZUgdmapSRBsUju5sYLTsAGW4dQXFzrm 0/+HlvqnGyc3rGd0cjbmoW56hOoSA7e5UZ1LSfDzYw1EMdhsZhucm8zA8IbNv2gtKhEB1E0qUFK iQO/RCrsHVT3hcwo/3s1yttzC9VXfujxEGaCAa4PdL8gZ9TzF0Gt3FxSCvb3Df5j2IIkSz3Vprm qNyGzU2c7GimvVT7jGlSauAxJUWCp5WCwR1lUuOrZEW6TmY6bEdrQly0faogXMvEyRa0hLFDkM0 06ZzCf3VDguDuJ/q2C634Mqpvql2xJigDqBOC9ynZaw4b1LkIQMfQMS4yJVUt/C/dc6bk6N5eXT 4VGgIk2GCJzpdnA== X-Developer-Key: i=krzysztof.kozlowski@linaro.org; a=openpgp; fpr=9BD07E0E0C51F8D59677B7541B93437D3B41629B v1 was only one patch, here: https://lore.kernel.org/linux-devicetree/20250710085814.21810-2-krzysztof.kozlowski@linaro.org/ Changes in v2: 1. Rephrase - use YAML instead of schema, add another example for conversion. 2. Three new patches (2-4). Best regards, Krzysztof --- Krzysztof Kozlowski (4): docs: dt: submitting-patches: Avoid 'YAML' in the subject and add an example docs: dt: writing-bindings: Document compatible and filename naming docs: dt: writing-bindings: Document discouraged instance IDs docs: dt: writing-schema: Document preferred order of properties Documentation/devicetree/bindings/submitting-patches.rst | 12 ++++++++++-- Documentation/devicetree/bindings/writing-bindings.rst | 13 +++++++++++++ Documentation/devicetree/bindings/writing-schema.rst | 3 +++ 3 files changed, 26 insertions(+), 2 deletions(-) --- base-commit: a62b7a37e6fcf4a675b1548e7c168b96ec836442 change-id: 20250713-dt-bindings-docs-a9d320095699 Best regards, -- Krzysztof Kozlowski