docs: maintainer: discourage taking conversations off-list
Subsystems (2)
PATCH v2 1/1 docs: maintainer: discourage taking conversations off-list
Multiple vendors seem to prefer taking discussions off list, and ask contributors to work with them privately rather than just send patches to the list. I'd imagine this is because it's hard to fit in time for random developers popping up with features to review into packed schedule. From what I've seen "work in private" usually means someone on the company side will be assigned to handle the interaction, possibly months later. In worst case, the person scheduled to help the contributor takes over and writes the code themselves. This is not how the community is supposed to work.
The discussion on v1 wasn't very conclusive. I am not capable of distilling many of the suggestions into meaningful changes. I believe the paragraph works in the context of the document.
FWIW the paragraph has been consulted with 2 contributors to whom the described situation has happened.
---
Encouraged by the immediate acks from notable folks I'm submitting again, although I'm tempted to resend as part of maintainer-netdev :( Please do read the rest of the doc to understand the context:
https://docs.kernel.org/next/maintainer/feature-and-driver-maintainers.html
v2:
- replace mailing list with "forum" to avoid excluding GH / GitLab etc
- call out private >email< conversations, face-to-face conversations are obviously fine
v1: https://lore.kernel.org/[email protected]/
--- .../maintainer/feature-and-driver-maintainers.rst | 11 +++++++++++ 1 file changed, 11 insertions(+)
Documentation/maintainer/feature-and-driver-maintainers.rst +11 -0
@@ -83,6 +83,17 @@ bugs as well, if the report is of reasonable quality or indicates a problem that might be severe -- especially if they have *Supported* status of the codebase in the MAINTAINERS file. +Open development +---------------- + +Discussions about user reported issues, and development of new code +should be conducted in a manner typical for the larger subsystem. +It is common for development within a single company to be conducted +behind closed doors. However, development and discussions initiated +by community members must not be redirected from public to closed forums +or to private email conversations. Reasonable exceptions to this guidance +include discussions about security related issues. + Selecting the maintainer ========================
Signature · 1 line
2.45.2
Jonathan Corbet
maintainerQuoted 14 lines · Jakub Kicinski
Multiple vendors seem to prefer taking discussions off list, and ask contributors to work with them privately rather than just send patches to the list. I'd imagine this is because it's hard to fit in time for random developers popping up with features to review into packed schedule. From what I've seen "work in private" usually means someone on the company side will be assigned to handle the interaction, possibly months later. In worst case, the person scheduled to help the contributor takes over and writes the code themselves. This is not how the community is supposed to work.
The discussion on v1 wasn't very conclusive. I am not capable of distilling many of the suggestions into meaningful changes. I believe the paragraph works in the context of the document.
Quoted 7 lines
FWIW the paragraph has been consulted with 2 contributors to whom the described situation has happened.
Reviewed-by Greg Kroah-Hartman <[email protected]>Reviewed-by Mark Brown <[email protected]>Reviewed-by Shuah Khan <[email protected]>Signed-off-by Jakub Kicinski <[email protected]>
After pondering on this for a while, I've decided to go ahead and apply this. The intent is good; we can always improve the execution if somebody has a good idea.
I do have to say that all of the "must" language in this document is a bit off-putting and may well convince potential maintainers that they don't actually want to play this game.
Thanks,
jon