xref: /openbmc/linux/Documentation/process/code-of-conduct-interpretation.rst (revision 7ae9fb1b7ecbb5d85d07857943f677fd1a559b18)
1f7e58584SGreg Kroah-Hartman.. _code_of_conduct_interpretation:
2f7e58584SGreg Kroah-Hartman
379dbeed3SGreg Kroah-HartmanLinux Kernel Contributor Covenant Code of Conduct Interpretation
479dbeed3SGreg Kroah-Hartman================================================================
579dbeed3SGreg Kroah-Hartman
6f7e58584SGreg Kroah-HartmanThe :ref:`code_of_conduct` is a general document meant to
779dbeed3SGreg Kroah-Hartmanprovide a set of rules for almost any open source community.  Every
879dbeed3SGreg Kroah-Hartmanopen-source community is unique and the Linux kernel is no exception.
979dbeed3SGreg Kroah-HartmanBecause of this, this document describes how we in the Linux kernel
1079dbeed3SGreg Kroah-Hartmancommunity will interpret it.  We also do not expect this interpretation
1179dbeed3SGreg Kroah-Hartmanto be static over time, and will adjust it as needed.
1279dbeed3SGreg Kroah-Hartman
1379dbeed3SGreg Kroah-HartmanThe Linux kernel development effort is a very personal process compared
1479dbeed3SGreg Kroah-Hartmanto "traditional" ways of developing software.  Your contributions and
1579dbeed3SGreg Kroah-Hartmanideas behind them will be carefully reviewed, often resulting in
1679dbeed3SGreg Kroah-Hartmancritique and criticism.  The review will almost always require
1779dbeed3SGreg Kroah-Hartmanimprovements before the material can be included in the
1879dbeed3SGreg Kroah-Hartmankernel.  Know that this happens because everyone involved wants to see
1979dbeed3SGreg Kroah-Hartmanthe best possible solution for the overall success of Linux.  This
2079dbeed3SGreg Kroah-Hartmandevelopment process has been proven to create the most robust operating
2179dbeed3SGreg Kroah-Hartmansystem kernel ever, and we do not want to do anything to cause the
2279dbeed3SGreg Kroah-Hartmanquality of submission and eventual result to ever decrease.
2379dbeed3SGreg Kroah-Hartman
2479dbeed3SGreg Kroah-HartmanMaintainers
2579dbeed3SGreg Kroah-Hartman-----------
2679dbeed3SGreg Kroah-Hartman
2779dbeed3SGreg Kroah-HartmanThe Code of Conduct uses the term "maintainers" numerous times.  In the
2879dbeed3SGreg Kroah-Hartmankernel community, a "maintainer" is anyone who is responsible for a
2979dbeed3SGreg Kroah-Hartmansubsystem, driver, or file, and is listed in the MAINTAINERS file in the
3079dbeed3SGreg Kroah-Hartmankernel source tree.
3179dbeed3SGreg Kroah-Hartman
3279dbeed3SGreg Kroah-HartmanResponsibilities
3379dbeed3SGreg Kroah-Hartman----------------
3479dbeed3SGreg Kroah-Hartman
3579dbeed3SGreg Kroah-HartmanThe Code of Conduct mentions rights and responsibilities for
3679dbeed3SGreg Kroah-Hartmanmaintainers, and this needs some further clarifications.
3779dbeed3SGreg Kroah-Hartman
3879dbeed3SGreg Kroah-HartmanFirst and foremost, it is a reasonable expectation to have maintainers
3979dbeed3SGreg Kroah-Hartmanlead by example.
4079dbeed3SGreg Kroah-Hartman
4179dbeed3SGreg Kroah-HartmanThat being said, our community is vast and broad, and there is no new
4279dbeed3SGreg Kroah-Hartmanrequirement for maintainers to unilaterally handle how other people
4379dbeed3SGreg Kroah-Hartmanbehave in the parts of the community where they are active.  That
4479dbeed3SGreg Kroah-Hartmanresponsibility is upon all of us, and ultimately the Code of Conduct
4579dbeed3SGreg Kroah-Hartmandocuments final escalation paths in case of unresolved concerns
4679dbeed3SGreg Kroah-Hartmanregarding conduct issues.
4779dbeed3SGreg Kroah-Hartman
4879dbeed3SGreg Kroah-HartmanMaintainers should be willing to help when problems occur, and work with
4979dbeed3SGreg Kroah-Hartmanothers in the community when needed.  Do not be afraid to reach out to
50d84feee7SGreg Kroah-Hartmanthe Technical Advisory Board (TAB) or other maintainers if you're
51d84feee7SGreg Kroah-Hartmanuncertain how to handle situations that come up.  It will not be
52d84feee7SGreg Kroah-Hartmanconsidered a violation report unless you want it to be.  If you are
53d84feee7SGreg Kroah-Hartmanuncertain about approaching the TAB or any other maintainers, please
54*5fddf896SShuah Khanreach out to our conflict mediator, Joanna Lee <jlee@linuxfoundation.org>.
5579dbeed3SGreg Kroah-Hartman
5679dbeed3SGreg Kroah-HartmanIn the end, "be kind to each other" is really what the end goal is for
5779dbeed3SGreg Kroah-Hartmaneverybody.  We know everyone is human and we all fail at times, but the
5879dbeed3SGreg Kroah-Hartmanprimary goal for all of us should be to work toward amicable resolutions
5979dbeed3SGreg Kroah-Hartmanof problems.  Enforcement of the code of conduct will only be a last
6079dbeed3SGreg Kroah-Hartmanresort option.
6179dbeed3SGreg Kroah-Hartman
6279dbeed3SGreg Kroah-HartmanOur goal of creating a robust and technically advanced operating system
6379dbeed3SGreg Kroah-Hartmanand the technical complexity involved naturally require expertise and
6479dbeed3SGreg Kroah-Hartmandecision-making.
6579dbeed3SGreg Kroah-Hartman
6679dbeed3SGreg Kroah-HartmanThe required expertise varies depending on the area of contribution.  It
6779dbeed3SGreg Kroah-Hartmanis determined mainly by context and technical complexity and only
6879dbeed3SGreg Kroah-Hartmansecondary by the expectations of contributors and maintainers.
6979dbeed3SGreg Kroah-Hartman
7079dbeed3SGreg Kroah-HartmanBoth the expertise expectations and decision-making are subject to
7179dbeed3SGreg Kroah-Hartmandiscussion, but at the very end there is a basic necessity to be able to
7279dbeed3SGreg Kroah-Hartmanmake decisions in order to make progress.  This prerogative is in the
7379dbeed3SGreg Kroah-Hartmanhands of maintainers and project's leadership and is expected to be used
7479dbeed3SGreg Kroah-Hartmanin good faith.
7579dbeed3SGreg Kroah-Hartman
7679dbeed3SGreg Kroah-HartmanAs a consequence, setting expertise expectations, making decisions and
7779dbeed3SGreg Kroah-Hartmanrejecting unsuitable contributions are not viewed as a violation of the
7879dbeed3SGreg Kroah-HartmanCode of Conduct.
7979dbeed3SGreg Kroah-Hartman
8079dbeed3SGreg Kroah-HartmanWhile maintainers are in general welcoming to newcomers, their capacity
8179dbeed3SGreg Kroah-Hartmanof helping contributors overcome the entry hurdles is limited, so they
8279dbeed3SGreg Kroah-Hartmanhave to set priorities.  This, also, is not to be seen as a violation of
8379dbeed3SGreg Kroah-Hartmanthe Code of Conduct.  The kernel community is aware of that and provides
8479dbeed3SGreg Kroah-Hartmanentry level programs in various forms like kernelnewbies.org.
8579dbeed3SGreg Kroah-Hartman
8679dbeed3SGreg Kroah-HartmanScope
8779dbeed3SGreg Kroah-Hartman-----
8879dbeed3SGreg Kroah-Hartman
8979dbeed3SGreg Kroah-HartmanThe Linux kernel community primarily interacts on a set of public email
9079dbeed3SGreg Kroah-Hartmanlists distributed around a number of different servers controlled by a
9179dbeed3SGreg Kroah-Hartmannumber of different companies or individuals.  All of these lists are
9279dbeed3SGreg Kroah-Hartmandefined in the MAINTAINERS file in the kernel source tree.  Any emails
9379dbeed3SGreg Kroah-Hartmansent to those mailing lists are considered covered by the Code of
9479dbeed3SGreg Kroah-HartmanConduct.
9579dbeed3SGreg Kroah-Hartman
9679dbeed3SGreg Kroah-HartmanDevelopers who use the kernel.org bugzilla, and other subsystem bugzilla
9779dbeed3SGreg Kroah-Hartmanor bug tracking tools should follow the guidelines of the Code of
9879dbeed3SGreg Kroah-HartmanConduct.  The Linux kernel community does not have an "official" project
9979dbeed3SGreg Kroah-Hartmanemail address, or "official" social media address.  Any activity
10079dbeed3SGreg Kroah-Hartmanperformed using a kernel.org email account must follow the Code of
10179dbeed3SGreg Kroah-HartmanConduct as published for kernel.org, just as any individual using a
10279dbeed3SGreg Kroah-Hartmancorporate email account must follow the specific rules of that
10379dbeed3SGreg Kroah-Hartmancorporation.
10479dbeed3SGreg Kroah-Hartman
10579dbeed3SGreg Kroah-HartmanThe Code of Conduct does not prohibit continuing to include names, email
10679dbeed3SGreg Kroah-Hartmanaddresses, and associated comments in mailing list messages, kernel
10779dbeed3SGreg Kroah-Hartmanchange log messages, or code comments.
10879dbeed3SGreg Kroah-Hartman
10979dbeed3SGreg Kroah-HartmanInteraction in other forums is covered by whatever rules apply to said
11079dbeed3SGreg Kroah-Hartmanforums and is in general not covered by the Code of Conduct.  Exceptions
11179dbeed3SGreg Kroah-Hartmanmay be considered for extreme circumstances.
11279dbeed3SGreg Kroah-Hartman
11379dbeed3SGreg Kroah-HartmanContributions submitted for the kernel should use appropriate language.
11479dbeed3SGreg Kroah-HartmanContent that already exists predating the Code of Conduct will not be
11579dbeed3SGreg Kroah-Hartmanaddressed now as a violation.  Inappropriate language can be seen as a
11679dbeed3SGreg Kroah-Hartmanbug, though; such bugs will be fixed more quickly if any interested
11779dbeed3SGreg Kroah-Hartmanparties submit patches to that effect.  Expressions that are currently
11879dbeed3SGreg Kroah-Hartmanpart of the user/kernel API, or reflect terminology used in published
11979dbeed3SGreg Kroah-Hartmanstandards or specifications, are not considered bugs.
12079dbeed3SGreg Kroah-Hartman
12179dbeed3SGreg Kroah-HartmanEnforcement
12279dbeed3SGreg Kroah-Hartman-----------
12379dbeed3SGreg Kroah-Hartman
12479dbeed3SGreg Kroah-HartmanThe address listed in the Code of Conduct goes to the Code of Conduct
12579dbeed3SGreg Kroah-HartmanCommittee.  The exact members receiving these emails at any given time
126d117a854SGreg Kroah-Hartmanare listed at https://kernel.org/code-of-conduct.html.  Members can not
127d117a854SGreg Kroah-Hartmanaccess reports made before they joined or after they have left the
128d117a854SGreg Kroah-Hartmancommittee.
12979dbeed3SGreg Kroah-Hartman
13026e54448SKristen Carlson AccardiThe Code of Conduct Committee consists of volunteer community members
13126e54448SKristen Carlson Accardiappointed by the TAB, as well as a professional mediator acting as a
13226e54448SKristen Carlson Accardineutral third party.  The processes the Code of Conduct committee will
13326e54448SKristen Carlson Accardiuse to address reports is varied and will depend on the individual
13426e54448SKristen Carlson Accardicircumstance, however, this file serves as documentation for the
13526e54448SKristen Carlson Accardigeneral process used.
13679dbeed3SGreg Kroah-Hartman
13779dbeed3SGreg Kroah-HartmanAny member of the committee, including the mediator, can be contacted
13879dbeed3SGreg Kroah-Hartmandirectly if a reporter does not wish to include the full committee in a
13979dbeed3SGreg Kroah-Hartmancomplaint or concern.
14079dbeed3SGreg Kroah-Hartman
14179dbeed3SGreg Kroah-HartmanThe Code of Conduct Committee reviews the cases according to the
14279dbeed3SGreg Kroah-Hartmanprocesses (see above) and consults with the TAB as needed and
14379dbeed3SGreg Kroah-Hartmanappropriate, for instance to request and receive information about the
14479dbeed3SGreg Kroah-Hartmankernel community.
14579dbeed3SGreg Kroah-Hartman
14626e54448SKristen Carlson AccardiAny decisions regarding enforcement recommendations will be brought to
14726e54448SKristen Carlson Accardithe TAB for implementation of enforcement with the relevant maintainers
14826e54448SKristen Carlson Accardiif needed.  A decision by the Code of Conduct Committee can be overturned
14926e54448SKristen Carlson Accardiby the TAB by a two-thirds vote.
15079dbeed3SGreg Kroah-Hartman
15179dbeed3SGreg Kroah-HartmanAt quarterly intervals, the Code of Conduct Committee and TAB will
15279dbeed3SGreg Kroah-Hartmanprovide a report summarizing the anonymised reports that the Code of
15379dbeed3SGreg Kroah-HartmanConduct committee has received and their status, as well details of any
15479dbeed3SGreg Kroah-Hartmanoverridden decisions including complete and identifiable voting details.
15579dbeed3SGreg Kroah-Hartman
15626e54448SKristen Carlson AccardiBecause how we interpret and enforce the Code of Conduct will evolve over
15726e54448SKristen Carlson Accarditime, this document will be updated when necessary to reflect any
15826e54448SKristen Carlson Accardichanges.
159