1 |
commit: 9b0775038bb995e0ef831ea5d9c35563991f8cb4 |
2 |
Author: Michał Górny <mgorny <AT> gentoo <DOT> org> |
3 |
AuthorDate: Sat Jan 11 22:35:25 2020 +0000 |
4 |
Commit: Michał Górny <mgorny <AT> gentoo <DOT> org> |
5 |
CommitDate: Sun Jan 19 10:51:28 2020 +0000 |
6 |
URL: https://gitweb.gentoo.org/proj/policy-guide.git/commit/?id=9b077503 |
7 |
|
8 |
Add a chapter on maintainers |
9 |
|
10 |
Closes: https://bugs.gentoo.org/705472 |
11 |
Closes: https://github.com/gentoo/policy-guide/pull/1 |
12 |
Signed-off-by: Michał Górny <mgorny <AT> gentoo.org> |
13 |
|
14 |
maintainer.rst | 73 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
15 |
1 file changed, 73 insertions(+) |
16 |
|
17 |
diff --git a/maintainer.rst b/maintainer.rst |
18 |
new file mode 100644 |
19 |
index 0000000..07dd3b1 |
20 |
--- /dev/null |
21 |
+++ b/maintainer.rst |
22 |
@@ -0,0 +1,73 @@ |
23 |
+Package Maintainers |
24 |
+=================== |
25 |
+ |
26 |
+.. index:: maintainer; adding |
27 |
+ |
28 |
+Adding new maintainers |
29 |
+---------------------- |
30 |
+:Source: QA |
31 |
+:Reported: no |
32 |
+ |
33 |
+Developers must not add other developers as package maintainers, unless |
34 |
+the developers in question consent to that. Developers must not add |
35 |
+projects that they are not members of as package maintainers, unless |
36 |
+one of the project members explicitly agrees to that or the project |
37 |
+policy explicitly permits it. |
38 |
+ |
39 |
+*Rationale*: this policy aims to prevent package maintainers being added |
40 |
+as backup maintainers without their consent or knowledge. What's worse, |
41 |
+once the original maintainer resigns the packages frequently drop |
42 |
+to backup maintainers who are neither interested in maintaining them, |
43 |
+nor often aware why they are listed as maintainers. |
44 |
+ |
45 |
+For example, developers used to frequently add Python team as a backup |
46 |
+maintainer to various packages not fitting the project's profile. This |
47 |
+includes various end-user programs written in Python. Many of those |
48 |
+packages ended up being maintained solely by Python, and distinguishing |
49 |
+them from packages actually within project's profile was hard. |
50 |
+ |
51 |
+ |
52 |
+.. index:: maintainer; new packages without |
53 |
+ |
54 |
+New packages without a maintainer |
55 |
+--------------------------------- |
56 |
+:Source: QA |
57 |
+:Reported: no |
58 |
+ |
59 |
+It is explicitly forbidden to add new packages without a dedicated |
60 |
+maintainer. This does not apply if the package in question is not |
61 |
+technically a new one but merely split out of unmaintained package. |
62 |
+ |
63 |
+*Rationale*: Gentoo is currently suffering from a very large number |
64 |
+of packages without a maintainer. There is a small group of developers |
65 |
+trying to fix them as necessary. It is unfair and inappropriate |
66 |
+to increase their maintenance burden by adding new packages and refusing |
67 |
+to take care of them. |
68 |
+ |
69 |
+ |
70 |
+.. index:: maintainer; removing |
71 |
+.. index:: up for grabs |
72 |
+ |
73 |
+Removing package maintainers |
74 |
+---------------------------- |
75 |
+:Source: QA |
76 |
+:Reported: no |
77 |
+ |
78 |
+When removing maintainers from a package, the developer must reassign |
79 |
+all bugs filed for it. Furthermore, when removing the last maintainer |
80 |
+for a package, the developer must add the following comment |
81 |
+to ``metadata.xml``:: |
82 |
+ |
83 |
+ <!-- maintainer-needed --> |
84 |
+ |
85 |
+Furthermore, the developer must send an 'up for grabs' mail |
86 |
+to gentoo-dev mailing list, containing the list of packages with |
87 |
+no maintainer. If possible, please include any information that could |
88 |
+be helpful to future maintainers. |
89 |
+ |
90 |
+*Rationale*: reassigning bugs is necessary to make sure that old bugs |
91 |
+are not lost assigned to developers who are no longer interested |
92 |
+in them. The maintainer-needed comment is meant to make it possible |
93 |
+to easily grep for unmaintained packages. The 'up for grabs' mails aim |
94 |
+to increase the chances of packages finding a new maintainers (compared |
95 |
+to them silently becoming maintainer-needed). |