| 1 |
The changes are: |
| 2 |
- Rename the title to "Projects and Herds" to put the emphasis |
| 3 |
on projects |
| 4 |
- Explain projects and subprojects in a new "Projects" section |
| 5 |
- Add a subsection for starting new projects |
| 6 |
- Add a subsection for joining/leaving a project |
| 7 |
- Put a warning label at the beginning of the "Herds" section, |
| 8 |
declare it obsolete, and preserve it for historical reasons |
| 9 |
|
| 10 |
Gentoo-Bug: https://bugs.gentoo.org/show_bug.cgi?id=572144 |
| 11 |
Gentoo-Bug: https://bugs.gentoo.org/show_bug.cgi?id=549490 |
| 12 |
Signed-off-by: Göktürk Yüksek <gokturk@××××××××××.edu> |
| 13 |
--- |
| 14 |
general-concepts/herds-and-projects/text.xml | 128 ++++++++++++++++++++++++++- |
| 15 |
1 file changed, 127 insertions(+), 1 deletion(-) |
| 16 |
|
| 17 |
diff --git a/general-concepts/herds-and-projects/text.xml b/general-concepts/herds-and-projects/text.xml |
| 18 |
index e030150..39813c8 100644 |
| 19 |
--- a/general-concepts/herds-and-projects/text.xml |
| 20 |
+++ b/general-concepts/herds-and-projects/text.xml |
| 21 |
@@ -1,10 +1,133 @@ |
| 22 |
<?xml version="1.0"?> |
| 23 |
<guide self="general-concepts/herds-and-projects/"> |
| 24 |
<chapter> |
| 25 |
-<title>Herds and Projects</title> |
| 26 |
+<title>Projects and Herds</title> |
| 27 |
|
| 28 |
<body> |
| 29 |
|
| 30 |
+<section> |
| 31 |
+<title>Projects</title> |
| 32 |
+<body> |
| 33 |
+ |
| 34 |
+<p> |
| 35 |
+The management structure of Gentoo, called the "metastructure", |
| 36 |
+is defined in |
| 37 |
+<uri link="https://wiki.gentoo.org/wiki/GLEP:39#Specification"> |
| 38 |
+GLEP 39</uri>. In Gentoo, a project is a group of developers working |
| 39 |
+towards a common goal in various different areas. For example, the |
| 40 |
+<uri link="https://wiki.gentoo.org/wiki/Project:Metastructure"> |
| 41 |
+Gentoo Metastructure Project</uri> oversees the developments |
| 42 |
+regarding the metastructure. There are other projects such as the |
| 43 |
+<uri link="https://wiki.gentoo.org/wiki/Project:Bug-wranglers"> |
| 44 |
+Bug Wranglers</uri> which works on assigning bugs reported on Gentoo |
| 45 |
+Bugzilla to the responsible developers/projects, or, the |
| 46 |
+<uri link="https://wiki.gentoo.org/wiki/Project:Devmanual"> |
| 47 |
+Devmanual</uri> which focuses on maintaining this document. Many |
| 48 |
+others are responsible for maintaining packages in the tree: the |
| 49 |
+<uri link="https://wiki.gentoo.org/wiki/Project:Base"> |
| 50 |
+Base-System</uri> focuses on compilers, toolchains and various other |
| 51 |
+system software; the |
| 52 |
+<uri link="https://wiki.gentoo.org/wiki/Project:Portage"> |
| 53 |
+Portage Development Project</uri> specializes in the development of |
| 54 |
+<path>sys-apps/portage</path>; the |
| 55 |
+<uri link="https://wiki.gentoo.org/wiki/Project:Proxy_Maintainers"> |
| 56 |
+Proxy Maintainers</uri> allows keen users to assume responsibility for |
| 57 |
+various packages in the official tree under the guidance of Gentoo |
| 58 |
+developers. A package maintained by a project needs to have the |
| 59 |
+project explicitly listed as a maintainer in its |
| 60 |
+<uri link="::ebuild-writing/misc-files/metadata">metadata.xml</uri>. |
| 61 |
+The full listing of all the projects can be found on |
| 62 |
+<uri link="https://api.gentoo.org/metastructure/projects.xml"> |
| 63 |
+api.gentoo.org</uri> or on the |
| 64 |
+<uri link="https://wiki.gentoo.org/wiki/Project:Gentoo">wiki</uri>. |
| 65 |
+</p> |
| 66 |
+ |
| 67 |
+<p> |
| 68 |
+Projects spanning a large area of topics can have multiple subprojects |
| 69 |
+specializing in particular fields within the domain of the parent |
| 70 |
+project and thus form a project hierarchy. For example, |
| 71 |
+<uri link="https://wiki.gentoo.org/wiki/Project:ComRel"> |
| 72 |
+Community Relations</uri> project mainly concerns itself with |
| 73 |
+inter-developer and user-developer relationships as well as upholding |
| 74 |
+the Gentoo Code of Conduct. |
| 75 |
+<uri link="https://wiki.gentoo.org/wiki/Project:Recruiters"> |
| 76 |
+Recruiters</uri> project, on the other hand, is tasked with |
| 77 |
+orchestrating the process of recruiting developers for Gentoo. Both |
| 78 |
+projects tackle different problems, yet, at the same time work towards |
| 79 |
+the common goal of improving and maintaining good relations in the |
| 80 |
+community. As such, both of these are subprojects of |
| 81 |
+<uri link="https://wiki.gentoo.org/wiki/Project:ComRes"> |
| 82 |
+Community Resources</uri> project. |
| 83 |
+</p> |
| 84 |
+ |
| 85 |
+<subsection> |
| 86 |
+<title>Starting New Projects</title> |
| 87 |
+<body> |
| 88 |
+ |
| 89 |
+<p> |
| 90 |
+According to the metastructure any developer may create a new |
| 91 |
+project. There are two procedures involved in starting a new project: |
| 92 |
+ |
| 93 |
+<ol> |
| 94 |
+ <li> |
| 95 |
+ Create a new project page <uri |
| 96 |
+ link="https://wiki.gentoo.org/wiki/Gentoo_Wiki:Developer_Central/Project_pages"> |
| 97 |
+ through the wiki</uri>. |
| 98 |
+ </li> |
| 99 |
+ <li> |
| 100 |
+ Post a Request For Comments (RFC) email to the gentoo-dev |
| 101 |
+ mailing list. |
| 102 |
+ </li> |
| 103 |
+</ol> |
| 104 |
+ |
| 105 |
+There is no approval required for the RFC and negative comments do not |
| 106 |
+block a developer from creating a project. Competing projects are |
| 107 |
+allowed to co-exist in Gentoo; existence of another project with |
| 108 |
+similar goals do not block another developer from starting a new |
| 109 |
+project with the same goals. |
| 110 |
+</p> |
| 111 |
+ |
| 112 |
+</body> |
| 113 |
+</subsection> |
| 114 |
+<subsection> |
| 115 |
+<title>Joining and Leaving a Project</title> |
| 116 |
+<body> |
| 117 |
+ |
| 118 |
+<p> |
| 119 |
+Members of a project are managed through the project's page on the |
| 120 |
+Gentoo Wiki. Each page has a "Project" template in its source which |
| 121 |
+lists the members of the project. Simply modifying the list is |
| 122 |
+sufficient for adding or removing a developer. Note that different |
| 123 |
+projects have different requirements and procedures for recruiting |
| 124 |
+developers, which may require prior arrangements to be made before |
| 125 |
+modifying the member list. |
| 126 |
+</p> |
| 127 |
+ |
| 128 |
+<p> |
| 129 |
+Developers should remember to add themselves to the alias by editing |
| 130 |
+<c><path>/var/mail/alias/misc/<alias name></path></c> on |
| 131 |
+dev.gentoo.org. For example, the alias for the Devmanual project is |
| 132 |
+located at <c>/var/mail/alias/misc/devmanual</c>, which corresponds to |
| 133 |
+the project email address <c>devmanual@g.o</c>. |
| 134 |
+</p> |
| 135 |
+ |
| 136 |
+</body> |
| 137 |
+</subsection> |
| 138 |
+ |
| 139 |
+</body> |
| 140 |
+</section> |
| 141 |
+ |
| 142 |
+<section> |
| 143 |
+<title>Herds</title> |
| 144 |
+<body> |
| 145 |
+ |
| 146 |
+<warning> |
| 147 |
+Herds have been declared obsolete as per the Gentoo Council's <uri |
| 148 |
+link="https://projects.gentoo.org/council/meeting-logs/20160110-summary.txt"> |
| 149 |
+decision on January 10, 2016</uri>. The following section is preserved |
| 150 |
+for historical purposes. |
| 151 |
+</warning> |
| 152 |
+ |
| 153 |
<p> |
| 154 |
A <e>herd</e> is a collection of packages with an associated set of maintainers. |
| 155 |
It can happen for example because of retirement that a herd has no developers |
| 156 |
@@ -27,6 +150,9 @@ as the <c>silo</c> bootloader). This is <e>not</e> always the case. |
| 157 |
</p> |
| 158 |
|
| 159 |
</body> |
| 160 |
+</section> |
| 161 |
+ |
| 162 |
+</body> |
| 163 |
</chapter> |
| 164 |
</guide> |
| 165 |
|
| 166 |
-- |
| 167 |
2.7.3 |
Archives