blob: 049cd2433fe73a3ceb103cae5c4cb6a7c1de963a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
<?xml version="1.0" encoding="UTF-8"?>
<devbook self="general-concepts/projects/">
<chapter>
<title>Projects</title>
<body>
<p>
The management structure of Gentoo, called the "metastructure", is
defined in
<uri link="https://www.gentoo.org/glep/glep-0039.html#specification">
GLEP 39</uri>. In Gentoo, a project is a group of developers working
towards a common goal in various different areas. For example, the
<uri link="https://wiki.gentoo.org/wiki/Project:Devmanual">
Devmanual</uri> project focuses on maintaining this document. Many
others are responsible for maintaining packages. Projects spanning a
large area of topics can have multiple subprojects specializing in
particular fields within the domain of the parent project and thus
form a project hierarchy.
</p>
<p>
A package maintained by a project needs to have the
project explicitly listed as a maintainer in its
<uri link="::ebuild-writing/misc-files/metadata/">metadata.xml</uri>.
The full listing of all the projects can be found on
<uri link="https://api.gentoo.org/metastructure/projects.xml">
api.gentoo.org</uri> or on the
<uri link="https://wiki.gentoo.org/wiki/Project:Gentoo">wiki</uri>.
</p>
</body>
<section>
<title>Starting new projects</title>
<body>
<p>
According to the metastructure any developer may create a new
project. There are two procedures involved in starting a new project:
</p>
<ol>
<li>
Create a new project page <uri
link="https://wiki.gentoo.org/wiki/Gentoo_Wiki:Developer_Central/Project_pages">
through the wiki</uri>.
</li>
<li>
Post a Request For Comments (RFC) email to the gentoo-dev
mailing list.
</li>
</ol>
<p>
There is no approval required for the RFC and negative comments do not
block a developer from creating a project. Competing projects are
allowed to co-exist in Gentoo; existence of another project with
similar goals do not block another developer from starting a new
project with the same goals.
</p>
</body>
</section>
<section>
<title>Joining and leaving a project</title>
<body>
<p>
Members of a project are managed through the project's page on the
Gentoo Wiki. Each page has a "Project" template in its source which
lists the members of the project. Simply modifying the list is
sufficient for adding or removing a developer. Note that different
projects have different requirements and procedures for recruiting
developers, which may require prior arrangements to be made before
modifying the member list. It is standard however to consult
the project lead.
</p>
<p>
If the project has an official IRC channel listed on its project page,
developers should join the channel if possible to facilitate
coordination and collaboration.
</p>
<p>
Developers should remember to add themselves to the alias by editing
<c>/var/mail/alias/misc/<alias name></c> on
dev.gentoo.org. For example, the alias for the Devmanual project is
located at <c>/var/mail/alias/misc/devmanual</c>, which corresponds to
the project's email address <c>devmanual@gentoo.org</c>.
</p>
</body>
</section>
</chapter>
</devbook>
|
GitWeb