From nobody Sat Jul 25 02:12:59 2026 Received: from mx0a-0031df01.pphosted.com (mx0a-0031df01.pphosted.com [205.220.168.131]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id B8C40442FBC for ; Mon, 20 Jul 2026 18:40:50 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=205.220.168.131 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784572853; cv=none; b=K7gtV4BKsWQ2cVz/Oxj3jlf8fOQ3NY0C/1eTYDTyTVxl/sGjUPFVbFDE1DBCZrSSG0lGtx5UaN4CcfkDlqHwwxBVR+qetvEAltlNA0URviatww1gGHF5ajDYSDqB8cDzl5z7chjIrV6vcKEBC+rVDoGm8LK6JoulEJd9ZwVaQJE= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784572853; c=relaxed/simple; bh=jb5f5jGGSKMqZNTu9/xrudl4febEVpxMAwYOHW3ZDHc=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:Content-Type; b=bqZdo8CbSRKrKGJ+wpxIon5rqELkQQWdo3LRB8NM5vqHLhNgxEmqQAMrO10e5VGGFfHBn4lTXF+W8+UIWrNq5F56lOnVjsaGzSE8SL4D3BZJlfqNpQhnvv80ZrNRGkPuuL/XVuE1jikekPbT7zovE+4eau9gNarS/tnFFkTawqc= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com; spf=pass smtp.mailfrom=oss.qualcomm.com; dkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com header.b=mPHqJK7Z; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b=iGVtiCk2; arc=none smtp.client-ip=205.220.168.131 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=oss.qualcomm.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com header.b="mPHqJK7Z"; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b="iGVtiCk2" Received: from pps.filterd (m0279866.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 66KH6TSC2962356 for ; Mon, 20 Jul 2026 18:40:50 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=qualcomm.com; h= cc:content-transfer-encoding:content-type:date:from:message-id :mime-version:subject:to; s=qcppdkim1; bh=LzzBPLy7PTw92eX+6/W1Mc dpFsBt8ydH/z1Z/cN0fks=; b=mPHqJK7Zs8uwrcVrWtU58qDlj8ZtC4+yxQC/Qy +m9+xoBByQC/3wYSblMAx8ztUQIQe4uy2B+OjNJhKuKZ622xAIWmVaAkuizY/80U b6e2jLuggrom+S7e9gpFhsVk7R7Ht/JrkYhBZR9Kwx6XGPNp0Jeo+GaATw3A+/9J Ms32tU5mCJQ9SXnH7+rmkAH6DOA3Yp/VXjnollt6GGvF3QrWKV9KIFG8a7wnK0L9 /ZnmFViokMpr0iHV8KC9VQK7a5TXcVcwyHV76BlXTO2Ay05G6ruwTsDK2vSL13/a abZnshf6LW/CyovjBrZQBzVk3d4fO4KSb3k9gAqn2If9y1aw== Received: from mail-qt1-f198.google.com (mail-qt1-f198.google.com [209.85.160.198]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 4fhh5y2fxc-1 (version=TLSv1.3 cipher=TLS_AES_128_GCM_SHA256 bits=128 verify=NOT) for ; Mon, 20 Jul 2026 18:40:49 +0000 (GMT) Received: by mail-qt1-f198.google.com with SMTP id d75a77b69052e-51a8db414c7so174711031cf.0 for ; Mon, 20 Jul 2026 11:40:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oss.qualcomm.com; s=google; t=1784572849; x=1785177649; darn=vger.kernel.org; h=content-transfer-encoding:content-type:mime-version:message-id:date :subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to :content-type; bh=LzzBPLy7PTw92eX+6/W1McdpFsBt8ydH/z1Z/cN0fks=; b=iGVtiCk2qdK8z9LNyBNvYyZdya04ESKTrwL7SywN+da92o3y5Db08sg9LN+XkewnUf JfExwl9P2M6o2q08UATMmf5yGoq9dip/5AhX16Ks5rU2mvXhXsl6lhUc2Pq1xTMQL3EN xNTe3sPguC9sGxQqBmZHfTWcKC5IkCrLvHXWdRJh/2hL5PwOxgSX2zIMTRnPRg9kVP5a 6RpRq9YfGhCPa5wrkobQosU/u8EIy8bg1ww8amWTb0R0lV6OrPsU4ai/72yziBPSc+zb cRzUWkMupxw0lrMZ39MtcSCQaBmCKuPS4iIfrqIo3ZyDyal0gU9Oq7rqZvkipqMxCeHm ktbg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1784572849; x=1785177649; h=content-transfer-encoding:content-type:mime-version:message-id:date :subject:cc:to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject :date:message-id:reply-to:content-type; bh=LzzBPLy7PTw92eX+6/W1McdpFsBt8ydH/z1Z/cN0fks=; b=lIRrJHFzzemZNCUkcFHDhBed/lTNm7AgAgBDhSwfLXWCpkn+K72eRMFm++0LuI8gK4 Hw/3vUyxMVAX4/hLknEaahgzXVB0ISRiZXfkW9aDWvqoJcFOkG85zdYd2wI14pr0MIdE iysIb3IxCoGhzREDXEkM81el9UTBxn9bkitJbYiI6xLZjUG1VCe5C2paSsuuQs5xpsE/ OmWdCp1DTRkfgHqdhOnrlwP3uog7RgwSkC/mc9YCF9rn0SWQtr3hMd1DVCmOidcey4fX 3RunUBIo4DH3k1N9pd5zDagsp3coJ5FRDyaD3fFK1kLOw4EYqlFX6OWLFUrLtP+KXPWx OxGA== X-Forwarded-Encrypted: i=1; AHgh+Rq9T5oNSZzlnV/dNo/V+aS+ahXejMZNyu9oyV0XgYoKZ96wX5mNPhOm0tlAetjcX4n/J9tkKgDqr0nMDR0=@vger.kernel.org X-Gm-Message-State: AOJu0YxY6kvrD4R5wUf4Tiee7GczV9kyet+yPQI8caIR1PEHOnvHlMSQ mLGMLCH8rKXUkSH7RMdp2Ug++PyP/AGJ+aFcRZX28JYaxanwk/UnLD9m1yhX3X7sfidJg0aSJjX QmEhlbzNqDfwF6VQJFEPX2c7wSUDx35MavNmowbME0kUHXprmWxYUzs5jnvVcdgfCDbQ= X-Gm-Gg: AfdE7cnFUajdKJWzkwiI4aOM4biHhJDPNCyGBXyMEq4NueUvbwvGjZKqIz+QY94/SXD DJE5gybaR96PYrO0FC0p51NcNfgahlKra5GSHjJQt+O2CvDI2gFjhNjvlQqdHNBwkP6IW4sXUE7 yiMUo6bHJN6IabFJauWsWNVwOeMFtbLZCz11/fTftrAS1ha8nWXeeHm11ryq+1DACQmAAVYdfxz ZKv9hMJBqNVk7C4psJNfSgabc6zNBpVTgkZy7oKXRg/tJI+MJDlsO7TCj+85viYmo+ym0ME2Pmq klrnbbIrHrRzhW8XCBu2oITz6dHmDOACyC7QDVmO4KjpAhM4hkUklPHMWAjq6ZoVnGsxFJQWxre 0/DAjGGBOU9D5hrBa X-Received: by 2002:a05:622a:2c8:b0:517:9570:c1bd with SMTP id d75a77b69052e-5213cec8dd6mr145534831cf.25.1784572848897; Mon, 20 Jul 2026 11:40:48 -0700 (PDT) X-Received: by 2002:a05:622a:2c8:b0:517:9570:c1bd with SMTP id d75a77b69052e-5213cec8dd6mr145534481cf.25.1784572848311; Mon, 20 Jul 2026 11:40:48 -0700 (PDT) Received: from quoll ([178.197.223.174]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-49565473f76sm6568755e9.6.2026.07.20.11.40.46 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 20 Jul 2026 11:40:47 -0700 (PDT) From: Krzysztof Kozlowski To: Rob Herring , Krzysztof Kozlowski , Conor Dooley , Jonathan Corbet , Shuah Khan , devicetree@vger.kernel.org, workflows@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Cc: Krzysztof Kozlowski , Saravana Kannan Subject: [PATCH v3] docs: dt: maintainer: Add Devicetree and OF maintainer profile document Date: Mon, 20 Jul 2026 20:40:40 +0200 Message-ID: <20260720184040.9870-2-krzysztof.kozlowski@oss.qualcomm.com> X-Mailer: git-send-email 2.53.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=5178; i=krzysztof.kozlowski@oss.qualcomm.com; h=from:subject; bh=jb5f5jGGSKMqZNTu9/xrudl4febEVpxMAwYOHW3ZDHc=; b=owEBbQKS/ZANAwAKAcE3ZuaGi4PXAcsmYgBqXmupqunCAGybzLowi9lhzcUVHoEwG50WyYtNa TccW3QRjmqJAjMEAAEKAB0WIQTd0mIoPREbIztuuKjBN2bmhouD1wUCal5rqQAKCRDBN2bmhouD 1zJyD/4oRGmKMjWEHoIeJl1hksX+ibwVYBZ76qnZoBAy106rkcj3/m/7GpXH3HXOKVpWfTCJYBq GWZLMFrGfU43MiDqamrAG5K8Ew3ihSaekliBFeZ8SgJuws5JUC8wNc8Z12ozvEAZADXFZ/Bep45 gSUzB6eLQDWS6gQNCImkJDf8pAKMB+nRqbvAHj7v2TmMrU3gCySb9hVLMhsZB2hBwEuB+wFXurH DaMzjJJx23S1Bj0wJcHlTo+VV+3SW4v7mxH4JGAIjjctSUUIxaL1O5sQfMigFy5qxxqbJXweXKj y77Z6Zwlqm71lOukxsyOvs4/khMZWG3sOehkcGviNv/IMrvGESyavtxRq+2hC5jHbGKLW1MuGy0 teyIa+a5DugrZ7gM30Ieul6nLIcTeuElholaQgITYnrxfxNKERcCN0QZINU6jhkQvM9DuMyQohS uvY63NQBnWpW2OtA/wP+Uj6CiD65DDGtt6LDDN27mWp4SjQ2uPgmIHwWDdwf38KjIztK48/VN/6 9fr/u+n2F3ii6roKgFUeLpIKWVKjbOHnPo/DCgcif4Qpj34l4+Z0rJWA4XaiO5/nXPuIs5TxAMR Pf97e4lE+/S3TP5utFlHAsUibwBcBX8aVss6pfv75Yx0vp9ekQsK1Ll7kAsG9WZ6RfTeTMq3iln 2Ni7+0BXc5aZcdA== X-Developer-Key: i=krzysztof.kozlowski@oss.qualcomm.com; a=openpgp; fpr=9BD07E0E0C51F8D59677B7541B93437D3B41629B Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Proofpoint-Spam-Info: AW1haW4tMjYwNzIwMDIwMyBTYWx0ZWRfX5HxzrA9saTY7 n0OWYiFc94s6mcy5L0ORRjVyb8d+p7uHkYVrHzC/E/CP+l9Mbbuoyl6KfFytyHeblpEtqrGsnH3 gWdGUH6V2XWO1rCM9XQrKHOrnkRaXGc= X-Proofpoint-GUID: oIqyBeQhEOt-q2_-h1wx2QBEi64_9HtM X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwNzIwMDIwMyBTYWx0ZWRfX0iJyiBHYIfX7 r99dxYJy7qUVH41RvqKja3ue0tdtBw7OtZrxww9QIBv600ImJfyJ3BvHSSuSzkp7gb10/3oho0y DiqttrlMYG2tGkEH8lqj1p8ZJMnDa2pQafHo9dQdmau79VwjF6Qt9qopOUnQgiFczIAvh85NHDs D6moF3q3RBYzJCdvjgyrQBrhFedM+z3pgCcC/mKSR/Fp+682kIzyIK/zjPuF/WvmCsrs6Bt9h0H 5cHCOtP8lzitAFhhkfqEJr5+bDtTUa3+/H2T4sBTk5xQ2qOI7L9pPPFlKss25r5EpirYUPVUjS7 UgpPGqpSbZn3SZHjypxl1XUR4CHQebuB/Dszcmm6EC1gGp6cR/3A8MfQshKW+ZrhSTCyhfOVtDE f+8AJe27iCJydZX+WYbxGiz+isXbcvJAIXZRvMhEW5BkVXa1AYa2r2KPLAvFaSrzGRE4zM7gFa2 3GUKzxwNS/VlSR3q6Bg== X-Proofpoint-ORIG-GUID: oIqyBeQhEOt-q2_-h1wx2QBEi64_9HtM X-Authority-Analysis: v=2.4 cv=f/x4wuyM c=1 sm=1 tr=0 ts=6a5e6bb2 cx=c_pps a=mPf7EqFMSY9/WdsSgAYMbA==:117 a=N6niishs+lR9UBL1FN3Qrw==:17 a=IkcTkHD0fZMA:10 a=RAioF0-LDSMA:10 a=s4-Qcg_JpJYA:10 a=VkNPw1HP01LnGYTKEx00:22 a=u7WPNUs3qKkmUXheDGA7:22 a=YMgV9FUhrdKAYTUUvYB2:22 a=VwQbUJbxAAAA:8 a=gEfo2CItAAAA:8 a=EUspDBNiAAAA:8 a=sLr6tAuWVrO0SpXXj6sA:9 a=3ZKOabzyN94A:10 a=QEXdDO2ut3YA:10 a=dawVfQjAaf238kedN5IG:22 a=sptkURWiP4Gy88Gu7hUp:22 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1143,Hydra:6.1.134,FMLib:17.12.100.49 definitions=2026-07-20_04,2026-07-20_03,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 phishscore=0 bulkscore=0 priorityscore=1501 clxscore=1015 adultscore=0 malwarescore=0 impostorscore=0 lowpriorityscore=0 spamscore=0 suspectscore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2606150000 definitions=main-2607200203 Document how Devicetree and Open Firmware maintainers handle their subsystem, especially focusing on two caveats: Devicetree subsystem handles patches with a minor difference comparing to other subsystems: while DT maintainers pick up OF code, they only provide review of DT bindings without applying these. All three DT bindings maintainers rely currently on Patchwork and due to enormous amount of emails per day, regardless how much DT maintainers try, they cannot read all the emails. Cc: Rob Herring Cc: Conor Dooley Cc: Saravana Kannan Cc: devicetree@vger.kernel.org Signed-off-by: Krzysztof Kozlowski Reviewed-by: Frank Li --- I expect patch to be picked up by Rob, after review. Changes in v3: 1. Add also F: entry Changes in v2: 1. Correct typos and trailing white spaces. 2. Fix order of P: after C: in maintainers. --- .../process/maintainer-devicetree.rst | 70 +++++++++++++++++++ MAINTAINERS | 3 + 2 files changed, 73 insertions(+) create mode 100644 Documentation/process/maintainer-devicetree.rst diff --git a/Documentation/process/maintainer-devicetree.rst b/Documentatio= n/process/maintainer-devicetree.rst new file mode 100644 index 000000000000..d8ffe752bf5d --- /dev/null +++ b/Documentation/process/maintainer-devicetree.rst @@ -0,0 +1,70 @@ +.. SPDX-License-Identifier: GPL-2.0 + +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +Devicetree and Open Firmware Subsystem +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +Other Process Documents +----------------------- + +Please see the documents in Documentation/devicetree/bindings/ for informa= tion +on how to write proper Devicetree bindings and how to submit patches. + +Patch Review and Handling +------------------------- + +Patches handled by Devicetree maintainers are processed differently depend= ing +on the patch type: + +1. Core OF driver code, e.g. drivers/of/: + patches are reviewed and applied by DT maintainers. + +2. Devicetree bindings: + patches are reviewed by DT maintainers but, except in certain cases, sh= ould + be applied by subsystem maintainers. See also *For kernel maintainers*= in + Documentation/devicetree/bindings/submitting-patches.rst. + +3. DTS and drivers: + DT maintainers might provide comments, but review is generally not expe= cted. + +Patchwork +~~~~~~~~~ + +Devicetree maintainers review patches using Patchwork, so the current stat= us of +a patch can be checked there. For typical driver submissions, Patchwork +receives the entire patch set, but only a few patches are usually Devicetr= ee +bindings that are reviewed by DT maintainers. + +Explanation of Patchwork statuses: + + - **New**: Not yet processed by the automation toolset. + - **Needs ACK**: Waiting for review by DT maintainers. + - **Handled Elsewhere**: Non-DT patch; not being reviewed here. + - **RFC**: Patch was likely ignored because it was an incomplete RFC. + - **Changes Requested**: Patch was reviewed and DT maintainers expect cha= nges. + - **Accepted**: Patch was reviewed and applied by DT maintainers to their= tree. + - **Not Applicable**: Patch was reviewed and is likely in good shape, wit= h a + *Reviewed-by* or *Acked-by* tag provided, but DT maintainers expect som= eone + else to apply it. + +Patch Re-review and Pinging +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Due to the high volume of email traffic, Devicetree maintainers do not read +every email they receive and instead rely on Patchwork during the review +process. They also often skip patches that have already been reviewed. + +As a result, maintainers might miss: + +1. Questions about already reviewed patches. +2. Pings, for example when a patch has been reviewed by DT maintainers but= has + not been picked up by subsystem maintainers. + +Such cases can be addressed by: + +1. Pinging DT maintainers on the IRC channel. +2. Dropping the DT maintainer=E2=80=99s *Acked-by* or *Reviewed-by* tag wh= en sending a new + version of the patch set, together with an explanation in the patch + changelog describing why the tag was removed and what is expected from = DT + maintainers. + diff --git a/MAINTAINERS b/MAINTAINERS index 0b6b9e6b3900..be6aa5d174c5 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -20285,6 +20285,7 @@ S: Maintained Q: http://patchwork.kernel.org/project/devicetree/list/ W: http://www.devicetree.org/ C: irc://irc.libera.chat/devicetree +P: Documentation/process/maintainer-devicetree.rst T: git git://git.kernel.org/pub/scm/linux/kernel/git/robh/linux.git F: Documentation/ABI/testing/sysfs-firmware-ofw F: drivers/of/ @@ -20306,8 +20307,10 @@ L: devicetree@vger.kernel.org S: Maintained Q: http://patchwork.kernel.org/project/devicetree/list/ C: irc://irc.libera.chat/devicetree +P: Documentation/process/maintainer-devicetree.rst T: git git://git.kernel.org/pub/scm/linux/kernel/git/robh/linux.git F: Documentation/devicetree/ +F: Documentation/process/maintainer-devicetree.rst F: arch/*/boot/dts/ F: include/dt-bindings/ =20 --=20 2.53.0