From 75597548b0d6e7a953f9a20437c6163071f5d9c9 Mon Sep 17 00:00:00 2001 From: Göktürk Yüksek Date: Sat, 13 Feb 2016 22:50:07 -0500 Subject: general-concepts/herds-and-projects: update per GLEP 67 #572144 #549490 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The changes are: - Rename the title to "Projects and Herds" to put the emphasis on projects - Explain projects and subprojects in a new "Projects" section - Add a subsection for starting new projects - Add a subsection for joining/leaving a project - Put a warning label at the beginning of the "Herds" section, declare it obsolete, and preserve it for historical reasons Gentoo-Bug: https://bugs.gentoo.org/show_bug.cgi?id=572144 Gentoo-Bug: https://bugs.gentoo.org/show_bug.cgi?id=549490 Signed-off-by: Göktürk Yüksek --- general-concepts/herds-and-projects/text.xml | 101 ++++++++++++++++++++++++++- 1 file changed, 100 insertions(+), 1 deletion(-) (limited to 'general-concepts') diff --git a/general-concepts/herds-and-projects/text.xml b/general-concepts/herds-and-projects/text.xml index e030150..81b1885 100644 --- a/general-concepts/herds-and-projects/text.xml +++ b/general-concepts/herds-and-projects/text.xml @@ -1,10 +1,106 @@ -Herds and Projects +Projects and Herds +
+Projects + + +

+The management structure of Gentoo, called the "metastructure", is +defined in + +GLEP 39. In Gentoo, a project is a group of developers working +towards a common goal in various different areas. For example, the + +Devmanual 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. +

+ +

+A package maintained by a project needs to have the +project explicitly listed as a maintainer in its +metadata.xml. +The full listing of all the projects can be found on + +api.gentoo.org or on the +wiki. +

+ + +Starting New Projects + + +

+According to the metastructure any developer may create a new +project. There are two procedures involved in starting a new project: + +

    +
  1. + Create a new project page + through the wiki. +
    2. +
  2. + Post a Request For Comments (RFC) email to the gentoo-dev + mailing list. +
    3. +
+ +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. +

+ + + + +Joining and Leaving a Project + + +

+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. +

+ +

+Developers should remember to add themselves to the alias by editing +/var/mail/alias/misc/<alias name> on +dev.gentoo.org. For example, the alias for the Devmanual project is +located at /var/mail/alias/misc/devmanual, which corresponds to +the project's email address devmanual@gentoo.org. +

+ + + + + +
+ +
+Herds + + + +Herds have been declared obsolete as per the Gentoo Council's +decision on January 10, 2016. The following section is preserved +for historical purposes. + +

A herd is a collection of packages with an associated set of maintainers. It can happen for example because of retirement that a herd has no developers @@ -26,6 +122,9 @@ has an associated sparc herd which maintains sparc-specific packages (suc as the silo bootloader). This is not always the case.

+ +
+ -- cgit v1.2.3-65-gdbad