Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

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>

authored by

Krzysztof Kozlowski and committed by
Arnd Bergmann
29ce0bca 26d77ce5

+37 -5
+37 -5
Documentation/process/maintainer-soc.rst
··· 30 30 The main SoC tree is housed on git.kernel.org: 31 31 https://git.kernel.org/pub/scm/linux/kernel/git/soc/soc.git/ 32 32 33 + Maintainers 34 + ----------- 35 + 33 36 Clearly this is quite a wide range of topics, which no one person, or even 34 37 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. 37 40 In this regard, "platform" usually refers to a series of SoCs from a given 38 41 vendor, for example, Nvidia's series of Tegra SoCs. Many submaintainers operate 39 42 on a vendor level, responsible for multiple product lines. For several reasons, ··· 46 43 47 44 Most of these submaintainers have their own trees where they stage patches, 48 45 sending pull requests to the main SoC tree. These trees are usually, but not 49 - always, listed in MAINTAINERS. The main SoC maintainers can be reached via the 50 - alias soc@kernel.org if there is no platform-specific maintainer, or if they 51 - are unresponsive. 46 + always, listed in MAINTAINERS. 52 47 53 48 What the SoC tree is not, however, is a location for architecture-specific code 54 49 changes. Each architecture has its own maintainers that are responsible for 55 50 architectural details, CPU errata and the like. 51 + 52 + Submitting Patches for Given SoC 53 + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 54 + 55 + All typical platform related patches should be sent via SoC submaintainers 56 + (platform-specific maintainers). This includes also changes to per-platform or 57 + shared defconfigs (scripts/get_maintainer.pl might not provide correct 58 + addresses in such case). 59 + 60 + Submitting Patches to the Main SoC Maintainers 61 + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 62 + 63 + The main SoC maintainers can be reached via the alias soc@kernel.org only in 64 + following cases: 65 + 66 + 1. There are no platform-specific maintainers. 67 + 68 + 2. Platform-specific maintainers are unresponsive. 69 + 70 + 3. Introducing a completely new SoC platform. Such new SoC work should be sent 71 + first to common mailing lists, pointed out by scripts/get_maintainer.pl, for 72 + community review. After positive community review, work should be sent to 73 + soc@kernel.org in one patchset containing new arch/foo/Kconfig entry, DTS 74 + files, MAINTAINERS file entry and optionally initial drivers with their 75 + Devicetree bindings. The MAINTAINERS file entry should list new 76 + platform-specific maintainers, who are going to be responsible for handling 77 + patches for the platform from now on. 78 + 79 + Note that the soc@kernel.org is usually not the place to discuss the patches, 80 + thus work sent to this address should be already considered as acceptable by 81 + the community. 56 82 57 83 Information for (new) Submaintainers 58 84 ------------------------------------