Skip to content

Commit b4330a7

Browse files
[doc] Add pylint's governance model and path to maintainership
1 parent f54dfd1 commit b4330a7

File tree

3 files changed

+54
-0
lines changed

3 files changed

+54
-0
lines changed
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
==============
2+
Governance
3+
==============
4+
5+
How to become a triager ?
6+
-------------------------
7+
8+
Contribute for more than 3 releases consistently. Do not be too opinionated, follow the code of conduct without
9+
requiring emotional works from the maintainers. It does not mean that disagreements are impossible, only that arguments
10+
should stay technical and reasonable so the conversation is civil and productive. Get unanimous approval or neutral
11+
agreement from current maintainers.
12+
13+
How to become a maintainer ?
14+
----------------------------
15+
16+
Contribute two big code merge requests over multiple releases (for example like one checker in 2.13 and one
17+
complicated bug fixes in 2.14). Otherwise contributing for more than 3 releases consistently with
18+
great technical and interpersonal skills. Become an expert in a part of the code that is not maintained
19+
well at the moment (if we feel we can't merge something without your review, you're going to be able to
20+
merge those yourself soon). Get unanimous approval or neutral agreement from current maintainers.
21+
22+
23+
How to get admin rights ?
24+
-------------------------
25+
26+
Contribute for several hundreds of commits over a long period of time with excellent interpersonal skills
27+
and code quality. Get unanimous approval or neutral agreement from current admins.
28+
29+
30+
How are decisions made ?
31+
------------------------
32+
33+
Everyone is expected to follow the code of conduct. pylint is a do-ocracy / democracy.
34+
You're not allowed to behave poorly because you contributed a lot. But if
35+
you're not going to do the future maintenance work, your valid opinions might not be
36+
taken into account by those that will be affected by it.
37+
38+
When something is not consensual users, maintainers, and admins discuss until an agreement is reached.
39+
40+
Depending on the difficulty of the discussion and the importance of a fast resolution, a decision can be taken:
41+
42+
- Unanimously between discussion participants, contributors and maintainers (preferably)
43+
44+
- By asking discussion participants for their opinions with an emoji survey in the issue and then using the majority
45+
if no maintainers feel strongly about the issue.
46+
47+
- By asking all users for their opinions in a new issue that will be pinned for multiple months before taking the decision
48+
if two maintainers feel strongly on an opposite side of the issue.

doc/development_guide/contributor_guide/index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,3 +13,4 @@ The contributor guide will help you if you want to contribute to pylint itself.
1313
tests/index
1414
profiling
1515
release
16+
governance

doc/whatsnew/fragments/8329.other

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
The governance model and the path to become a maintainer have been documented as
2+
part of our effort to guarantee that the software supply chain in which pylint is
3+
included is secure.
4+
5+
Refs #8329

0 commit comments

Comments
 (0)