From nobody Mon May 25 05:58:56 2026 Received: from mx0b-0031df01.pphosted.com (mx0b-0031df01.pphosted.com [205.220.180.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 5CF4F305699 for ; Mon, 18 May 2026 09:20:03 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=205.220.180.131 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1779096005; cv=none; b=pqPikq/y9Fz4z+jm853C71d3XOTUyAD0d+2YIs/jnoauSPopDqEnwFxjQOdw5tHwjIOY2OC3/BSSN8kfKg0Xa0YYjE5v6FOykj7fZf0wEN46H42jTgFAJabO+e3EqGlnaC+wfldt1388CZ/Xphy5XQFX2d+FFjJcqje0z2wtxE4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1779096005; c=relaxed/simple; bh=MywEWsbnG8C6ngvsR4dw6Oxcahx3+ItSZfhu87dPrc0=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:Content-Type; b=exWByCFj0MDwkuH20uPcg07L6GC9blNkjgNp66cr7WyRzi1U19phDm6OI3LczI3q54IeS3pltQAzl2Ylji3WxfjLIItoqsrIhgxmV05+ZRBFd7EteAz4OHsI7hXFYBmXSucY+CZ18Sr4RONMA+gpbFGLCqYhABP9zOiT1eHnk9Y= 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=X7xPW22w; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b=P8EBzLNS; arc=none smtp.client-ip=205.220.180.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="X7xPW22w"; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b="P8EBzLNS" Received: from pps.filterd (m0279872.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 64I7figL2189416 for ; Mon, 18 May 2026 09:20:02 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=I18mqyGP+9h9hQQewvDHdR JLfyFJ2fL/hYo7DB9EfNE=; b=X7xPW22wrdHv/qJT1WoxNBi9i4pPo4d7eCtG5f OoQPAm8WqjeVdKdn8vlqG85IErxImGX9EnD4ve0fciTehhmp6mqWQg/0vgR7wDeV PSioE22RIdZABUPeiZOe6i+OGe2whCPzV+iqrXZ7vRH9+VvX52QZWyx7cWt5WyGB nfSd7PHQqbJKtn2ZnyHZ/LgiBHjuzcscXrgzMMWCWTWnKNXn3roBrTBzzHGYALAL /0xkPVxrhxP+cxUAd9HjuV/WGdnWTavvKUUJ1bn3QpXm7P/trdc1j+EVxDwyoQgB cQqBjffaAfZDPt2ed/ds3B2qBfQnobDazT/OeKjD5nY3BVHQ== Received: from mail-qt1-f199.google.com (mail-qt1-f199.google.com [209.85.160.199]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 4e7xkugdad-1 (version=TLSv1.3 cipher=TLS_AES_128_GCM_SHA256 bits=128 verify=NOT) for ; Mon, 18 May 2026 09:20:02 +0000 (GMT) Received: by mail-qt1-f199.google.com with SMTP id d75a77b69052e-50fbc49bef6so43969871cf.0 for ; Mon, 18 May 2026 02:20:02 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oss.qualcomm.com; s=google; t=1779096001; x=1779700801; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=I18mqyGP+9h9hQQewvDHdRJLfyFJ2fL/hYo7DB9EfNE=; b=P8EBzLNSb/r2lWcr2EO/BqCn0sSpuEEzwsA/PanKb/ODl+p/O5YnMvRSW1MwmkQC/o NkxMe9QFDanav6B0yQrp2MhLgOAFl7DUtGw/MfEaKT8F5mU+AytM8NK6OW4pfFUMc5wd JBY7/Umw/aO5gglCHoahqGwG1cLvLLVRNZh7gFNdusw6IHuzowfcdgOaFWyZjB80+Hhy +7Tkygtxk0+zmTh5PJLzDV1ZuSOGvpHey4w7ybI+UhP9ydqVovN8J3qJ8UkX4/2676pZ KZXKBXl2THtSXuIhRWrUWcKwHsvrH/3r62PCP0NO4PJDc3a9ZXI08vq5wMNCMvyhuV1E +h1Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1779096001; x=1779700801; h=content-transfer-encoding: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; bh=I18mqyGP+9h9hQQewvDHdRJLfyFJ2fL/hYo7DB9EfNE=; b=JMA/SYofkyKUT37QPP3bMsOuCKWMo6BHovnFCaVTOpyk+f9lb8LVzT8I9+5mN4LbtO Fq97JEESqRHqp67pdpgGO/hOqFcV6491yCrrbY+SgKiNg0t38+AlvWjm5An2sxMhQv5k fjjlNYdCPITNVE4maq9yLQfGlonNzaZGB96KoRgUHSAXzUvux3sayqoH/tBP/GQUcRsu q0b/O8uKjMRaUqkJzw+7awvQ6O+O8SV1rJNFgLWDhZoxoY+iXqGGEuBGkAbjFJRwf4GG pKHVJP/32OlYOINDEl4ZsdGPRf/77otbb4JpilvJ/IGwbsoHvsRCU0f1Pq1yel1FuE4v +jnA== X-Forwarded-Encrypted: i=1; AFNElJ/g6T6rZfIcTIlm7q95HbGqxF6Vc3nU1UCZ5QHpuaMWPlC+uwFPHwZOyQPoLyp4FmvqNi1y+0xMo9FDzwY=@vger.kernel.org X-Gm-Message-State: AOJu0YxwXuaYfJVd4nAH16J2eFreygFEVNk0igRrPkBH8cp1kDD9ys8V EYAGuBQ+djrSEoaHGLhrDFNiq8E1UWWdG011ie0xlRQHN/vS1iHyJFOOhuOKy3ahqBZ7tQvVa5n ZvOAK0PQYk6P8+7AC21VXlnG9g+12zA1ing7A8MjgwqcHoTP9Au+UZT2oiFPVYiAsi+a2aKwqDk Q= X-Gm-Gg: Acq92OE4o+MT7YRJcLU97fXl09NbYT8uhj2FUSqmd1WC1TMdmFbgOaac+gmUED6ReCP waeR/PaUS4JHVgL9HTLDw5AVX3CElhFSN9f3p6pxH/q49/Gl3YppUaUsfu7TrdhbKVWs0OLOv+0 PEZrJzO79m8KL3XtV69wYNu87ZVOLtc5/gbR0/zL64p2kuAmr+uuSQhWEXpexmk2a4aYg03rpsT EYimOT6WMOkPT9J/mix3L0gaA2THdl/TB+hTOjUC8reuCyzAB8XIkp2BJZJ9Bg/mnMPbtxJVD4T Mc6PNV99g5s/VwJjLYbUUVvyydHigMe8H1uR6iECntlUnHfgfQW09k+MLctxMr2udcpi7lGjgDq QFwTiHEqkp8dTWdFLOIHGQG8NfAsF3offTbyv X-Received: by 2002:ac8:5d14:0:b0:50b:404a:746e with SMTP id d75a77b69052e-5165a22c052mr194216261cf.47.1779096001443; Mon, 18 May 2026 02:20:01 -0700 (PDT) X-Received: by 2002:ac8:5d14:0:b0:50b:404a:746e with SMTP id d75a77b69052e-5165a22c052mr194216131cf.47.1779096001043; Mon, 18 May 2026 02:20:01 -0700 (PDT) Received: from quoll ([178.197.219.94]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-48ff43f8799sm126595765e9.2.2026.05.18.02.19.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 18 May 2026 02:20:00 -0700 (PDT) From: Krzysztof Kozlowski To: Jonathan Corbet , Shuah Khan , workflows@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Cc: Krzysztof Kozlowski , Rob Herring , Conor Dooley , Saravana Kannan , devicetree@vger.kernel.org Subject: [PATCH] docs: dt: maintainer: Add Devicetree and OF maintainer profile document Date: Mon, 18 May 2026 11:19:41 +0200 Message-ID: <20260518091942.29822-2-krzysztof.kozlowski@oss.qualcomm.com> X-Mailer: git-send-email 2.51.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=4966; i=krzysztof.kozlowski@oss.qualcomm.com; h=from:subject; bh=MywEWsbnG8C6ngvsR4dw6Oxcahx3+ItSZfhu87dPrc0=; b=owEBbQKS/ZANAwAKAcE3ZuaGi4PXAcsmYgBqCtmumnqtz2DrrUYmcqtjtL+zj9KSzXza91qhN 4vD8nd0ScKJAjMEAAEKAB0WIQTd0mIoPREbIztuuKjBN2bmhouD1wUCagrZrgAKCRDBN2bmhouD 144JD/92rFjLhf/92xycJGocLdfGFaVBF38rs2t3jyw2nINyTbk3bmFcdJ+qQ15Phpu0nwrjkBS kN5TL5zBtS1lWzgth7hPSasnXYt9l2++lAZF4NFrYlCDyJOAidiEUERDRe17D1bubQGN3OoF19R 1Cyf1d8dmSs/CbTjlcmKrapsiIoOtev6BFfq0QKF7BFcU8IKcTu2Icblo/NjucSLeJqf8cDU4nc heI90GMHoADwGCP/r52UdVRXvGFCOAvrJ7ztUJXa9Ob8vqJ8GqTEmIqJh9RZDQfWay3S3Nrnv1f yuqkW2/sQFjKfqJGikHL/nMusKn0mNdLcRZwncZLiOXIKOgIcEv5NFSovy5DU2ZRfDmX7Ape2uA Bxyw+yfOT5a4GLGMaWKLfQ+4J28x/xnZl0VRhVq1fHvfxw6H1yF9GI7sEOTtK1HA8T0ypoyUCSx N9wj6s5lElz1nMJxwsreTkEcxRWzoFY+NZaGOKIJoOcfeNio3tqG3H0Uo2/BPYnKTZNWQbHf0dj 7rHJctO29PtNxpEf3/L62THABh6WQSpETSgdEipvyonvgXiscVL39z1OlEYN1KS+CvAq3voq1p4 hG29sIF89P7RxKCuFJEbOl3oJHmrOeV+4/EE4ue5yGsxkDZMy3o2HxyCtIAZm41UPKA37HepIxS WlUVXarRsr8FZOA== 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-Details-Enc: AW1haW4tMjYwNTE4MDA4OSBTYWx0ZWRfX5YuSrJydumbj RLMlwMtepnyp03SMM5VIhxE6aY9yhK5I7x87UF0CFTXUVoSNdXKeBpUla7L5qw8fPEeMfGxzKcW WJ3klLfM8ZCiWzom6xNJoJPukWEp7q0LcSBs7P6FUqPUs0SBOObjWg763Nj+1yygzYOWjsbSCBr cwKzY+HE5G6wXNgQsxYZf9yyn/L9xw5RFuG9681xxVYrK219/WHGJlGlMEhzZgrLm341L7MirSO wVz2TP8cnyqXw47mzetuFTDyqtWmEmO0zJtiYUkKDH55dp3hSZLcR3LU45+1Cj/bTQ/AWmiNMri YynP5NohFj8jyvva1UztBaPuXxwMhStjeyOlGIr141KnphSzHfezrbjXreAEG5ExHXq/XHD8n1u xvDQK92glzALaJiXSZyOU7vtcqYr+S9tQxJ9FHZveBj9uRqwD4Shqapql+uAOdZslqrz66YTKjD J+xNNrpZk0j0TFt7Sqw== X-Proofpoint-GUID: BFfrCY_skg4ySUjeK_icOluDAALcdlGb X-Proofpoint-ORIG-GUID: BFfrCY_skg4ySUjeK_icOluDAALcdlGb X-Authority-Analysis: v=2.4 cv=FsY1OWrq c=1 sm=1 tr=0 ts=6a0ad9c2 cx=c_pps a=WeENfcodrlLV9YRTxbY/uA==:117 a=gOEeR9iKwsj33Yj5oN/cWg==:17 a=IkcTkHD0fZMA:10 a=NGcC8JguVDcA:10 a=s4-Qcg_JpJYA:10 a=VkNPw1HP01LnGYTKEx00:22 a=u7WPNUs3qKkmUXheDGA7:22 a=yx91gb_oNiZeI1HMLzn7:22 a=VwQbUJbxAAAA:8 a=gEfo2CItAAAA:8 a=EUspDBNiAAAA:8 a=7C85NsCI5bDNKhsY0GcA:9 a=3ZKOabzyN94A:10 a=QEXdDO2ut3YA:10 a=kacYvNCVWA4VmyqE58fU:22 a=sptkURWiP4Gy88Gu7hUp:22 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1143,Hydra:6.1.51,FMLib:17.12.100.49 definitions=2026-05-18_02,2026-05-15_01,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=0 adultscore=0 clxscore=1015 phishscore=0 priorityscore=1501 malwarescore=0 impostorscore=0 spamscore=0 lowpriorityscore=0 bulkscore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2605130000 definitions=main-2605180089 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 --- I expect patch to be picked up by Rob, after review. --- .../process/maintainer-devicetree.rst | 70 +++++++++++++++++++ MAINTAINERS | 2 + 2 files changed, 72 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..331701bb2282 --- /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. + =20 +3. DTS and drivers: + DT maintainers might provide comments, but review is generally not expe= cted. + +Pachwork +~~~~~~~~ + +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 statutes: + + - **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 f877e5aaf2c7..c4929de50ab7 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -20050,6 +20050,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/ @@ -20070,6 +20071,7 @@ M: Conor Dooley L: devicetree@vger.kernel.org S: Maintained Q: http://patchwork.kernel.org/project/devicetree/list/ +P: Documentation/process/maintainer-devicetree.rst C: irc://irc.libera.chat/devicetree T: git git://git.kernel.org/pub/scm/linux/kernel/git/robh/linux.git F: Documentation/devicetree/ --=20 2.51.0