Skip to content

Commit 29ce0bc

Browse files
krzkarndb
authored andcommitted
Documentation/process: maintainer-soc: clarify submitting patches
Patches for SoCs are expected to be picked up by SoC submaintainers. The main SoC maintainers should be addressed only in few cases. Rewrite the section about maintainer handling to document above expectation. Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> Reviewed-by: Linus Walleij <linus.walleij@linaro.org> Reviewed-by: Kevin Hilman <khilman@baylibre.com> Reviewed-by: Bagas Sanjaya <bagasdotme@gmail.com> Cc: Linus Walleij <linus.walleij@linaro.org> Cc: Alexandre Belloni <alexandre.belloni@bootlin.com> Cc: Will Deacon <will@kernel.org> Cc: Kevin Hilman <khilman@baylibre.com> Cc: Palmer Dabbelt <palmer@dabbelt.com> Cc: Geert Uytterhoeven <geert+renesas@glider.be> Cc: Conor Dooley <conor@kernel.org> Cc: Heiko Stübner <heiko@sntech.de> Link: https://lore.kernel.org/r/20240925095635.30452-1-krzysztof.kozlowski@linaro.org Signed-off-by: Arnd Bergmann <arnd@arndb.de>
1 parent 26d77ce commit 29ce0bc

1 file changed

Lines changed: 37 additions & 5 deletions

File tree

Documentation/process/maintainer-soc.rst

Lines changed: 37 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -30,10 +30,13 @@ tree as a dedicated branch covering multiple subsystems.
3030
The main SoC tree is housed on git.kernel.org:
3131
https://git.kernel.org/pub/scm/linux/kernel/git/soc/soc.git/
3232

33+
Maintainers
34+
-----------
35+
3336
Clearly this is quite a wide range of topics, which no one person, or even
3437
small group of people are capable of maintaining. Instead, the SoC subsystem
35-
is comprised of many submaintainers, each taking care of individual platforms
36-
and driver subdirectories.
38+
is comprised of many submaintainers (platform maintainers), each taking care of
39+
individual platforms and driver subdirectories.
3740
In this regard, "platform" usually refers to a series of SoCs from a given
3841
vendor, for example, Nvidia's series of Tegra SoCs. Many submaintainers operate
3942
on a vendor level, responsible for multiple product lines. For several reasons,
@@ -43,14 +46,43 @@ MAINTAINERS file.
4346

4447
Most of these submaintainers have their own trees where they stage patches,
4548
sending pull requests to the main SoC tree. These trees are usually, but not
46-
always, listed in MAINTAINERS. The main SoC maintainers can be reached via the
47-
alias soc@kernel.org if there is no platform-specific maintainer, or if they
48-
are unresponsive.
49+
always, listed in MAINTAINERS.
4950

5051
What the SoC tree is not, however, is a location for architecture-specific code
5152
changes. Each architecture has its own maintainers that are responsible for
5253
architectural details, CPU errata and the like.
5354

55+
Submitting Patches for Given SoC
56+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
57+
58+
All typical platform related patches should be sent via SoC submaintainers
59+
(platform-specific maintainers). This includes also changes to per-platform or
60+
shared defconfigs (scripts/get_maintainer.pl might not provide correct
61+
addresses in such case).
62+
63+
Submitting Patches to the Main SoC Maintainers
64+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
65+
66+
The main SoC maintainers can be reached via the alias soc@kernel.org only in
67+
following cases:
68+
69+
1. There are no platform-specific maintainers.
70+
71+
2. Platform-specific maintainers are unresponsive.
72+
73+
3. Introducing a completely new SoC platform. Such new SoC work should be sent
74+
first to common mailing lists, pointed out by scripts/get_maintainer.pl, for
75+
community review. After positive community review, work should be sent to
76+
soc@kernel.org in one patchset containing new arch/foo/Kconfig entry, DTS
77+
files, MAINTAINERS file entry and optionally initial drivers with their
78+
Devicetree bindings. The MAINTAINERS file entry should list new
79+
platform-specific maintainers, who are going to be responsible for handling
80+
patches for the platform from now on.
81+
82+
Note that the soc@kernel.org is usually not the place to discuss the patches,
83+
thus work sent to this address should be already considered as acceptable by
84+
the community.
85+
5486
Information for (new) Submaintainers
5587
------------------------------------
5688

0 commit comments

Comments
 (0)