This GLEP is no longer maintained in the Gentoo Wiki and remains here only as a historical record. Please visit https://www.gentoo.org/glep/glep-0004.html for the current version of this GLEP.
|GLEP 4: Gentoo top-level management structure proposal|
|Author||Daniel Robbins <firstname.lastname@example.org>|
|Editor||Kurt Lieber <email@example.com>|
|Replaced by||39 (An "old-school" metastructure proposal with "boot for being a slacker")|
What is the purpose of this proposal?
The purpose of this proposal is to solve chronic management, coordination and communication issues in the Gentoo project. In particular, currently we have no clearly defined top-level management structure, and no official, regular meetings to communicate status updates between developers serving in critical roles. In general, most communication takes place on irc and irregularly via email. There is also little to no accountability, even at a high level, to complete projects on time.
Because of this current state of affairs, it is difficult to set goals and track the status of projects. This lack of communication and coordination also makes it difficult for top-level developers to manage their own projects. In addition, we have the other chronic problem of not having clearly-defined roles and scopes of executive decision-making authority for top-level developers, which results in many top-level developers doubting that they even have the authority to manage their own projects and sub-projects. While this has *never* been the intention of top-level developers, it is the unfortunate result of an unstructured development process: no one knows what is going on, and everyone defers to the Chief Architect for all executive decisions.
Clearly, a plan is needed to swiftly and permanently address these issues by increasing communication, coordination, and accountability. Roles and scopes of executive decision-making authority need to be defined for top developers so that they have a clear mandate as well as accountability to manage their projects and thus ensure their projects complete their appointed work efficiently and on-schedule.
How do we fix this?
This proposal suggests fixing this issue by creating an official top-level management structure. This management structure will consist of the chief architect and a group of developers that will be given the title of "Top-level managers." Top-level managers will be accountable for the projects they manage, and be responsible for communicating the status of their projects to the rest of the top-level managers and chief architect, among other things detailed later in this document.
All the top-level projects in the Gentoo project will be clearly defined, including with goals, sub-projects, members, roadmap and schedules. The "Hardened Gentoo" page at http://www.gentoo.org/proj/en/hardened/ is an excellent example of such a top-level project definition.
Certain executive decision-making authority will be granted to these projects, as agreed upon by the top-level managers and project members. Then, a top-level manager or managers will be officially adopt projects. These managers will be responsible for tracking the status of the project, ensuring that the project meets targets and is generally managed properly. Manager responsibilities are described in detail later in this document.
The operational manager of each top-level project will also be responsible to report the status of the project in regular weekly status meetings in which all top-level managers will participate. This regular communication will allow proper coordination, goal-setting and scheduling to take place.
Types of management
For top-level projects, there are currently two possible types of managers. Each project must have at least one manager of each type, although one person may serve both roles. The first type of manager is the operational manager, who is granted executive authority for the day-to-day running of the project. Because this person is directly involved in the day-to-day running of the project, this person has the responsibility to communicate project status to the rest of the top-level management team.
The other type of manager is the strategic manager. The tactical manager has executive decision-making authority over the long-term strategic direction of the project. This manager's involvement in the day-to-day operations of the project is limited. Both strategic and operational management are equally important for a successful project.
Proposed initial top-level management team is as follows (in no particular order):
Seemant Kulleen (seemant) Jay Pfeifer (pfeifer) Joshua Brindle (method) Kurt Lieber (klieber) Nick Jones (carpaski) Pieter Van den Abeele (pvdabeel) Jon Portnoy (avenj)
In addition to Daniel Robbins, serving as Chief Architect.
- ) Constructive, professional communication: All communication should be focused on improving the management of Gentoo projects, should be constructive in nature and should be shared in a friendly, professional manner.
- ) Accountability to peers: Allow fellow members of this list to hold us accountable to follow-through on projects and meet deadlines. Keep fellow members accountable.
- ) Management of projects: empower managers to have the authority and strategic direction necessary to properly manage thier projects and efforts to ensure projects complete their appointed work on time.
- ) Results: our expectation is that our efforts, when properly executed, will result in the Gentoo project's ability to meet deadlines, have much better communication and coordination throughout the entire project, higher overall quality and a more positive experience for all.
Every top-level Gentoo project will have a clearly defined scope, and clearly defined and explicit executive decision-making authority that will be granted to managers of the project to exercise and/or delegate as they see fit. Both the scope and any necessary decision-making authority must be agreed upon by both the chief architect and project members. The scope and executive authority of a project can be expanded over time as required as approved by the top level managers.
In addition to decision-making authority, managers have the following responsibilities:
- Keep a complete list of all projects and efforts you are managing, and associated gentoo.org project page up-to-date
- Manage and track the status of these efforts. This includes active direction as well as passive tracking of progress.
- Define clear goals, roadmaps and timelines (preliminary if necessary) for every effort.
- Proactively identify efforts that have problems and need help.
- Ensure that your efforts are completed on-time, or that any efforts that are behind-schedule are reported in a timely manner.
- Remain focused. Make sure that you are not managing more than you can handle.
- Fulfill formal communication and coordination responsibilities required by top-level managers (weekly meetings, etc.)
- Fulfill formal communication and coordination responsibilities required by individual efforts (project meetings, communication with project members, etc.) This is *important* -- our management of projects means that we have the responsibility not only to communicate with our peers but also those who we are managing. This communication should be frequent, have a formal component (planned meetings, official status updates, etc.) and model good management practices to members of our teams.
- RECURSIVE FUNCTIONALITY: At an appropriate time, implement these management practices for *sub*-projects (define managers, clear sub-project goals, grant executive authority) with you serving as primary authority.
The gentoo-managers list will be created as the official email communications channel for all top-level Gentoo Linux managers.
The tenative plan for top-level management coordination is as follows:
Monday full status email:
Every Monday afteroon, every member of this list posts a status summary of projects/efforts that they are managing, as well as any items that they would like to discuss "live" on IRC in the upcoming "live" meeting. If you are unable to attend the "live" IRC meeting, an email to this list mentioning your inability to attend should be posted by Monday afternoon or before.
The goal of the Monday afternoon email is to get every other top-level manager up to speed on the status of your efforts and any efforts managed by you, and to have a tenative meeting agenda in place for the "live" IRC meeting.
Monday IRC chat:
On Monday evening, we convene on irc for a "live" meeting. The goal of this meeting isn't to provide status updates on our projects, but to work out any outstanding hands-on issues relating to the management of Gentoo Linux. These issues can include:
- Assignment of unmanaged projects
- Resolving critical, time-sensitive problems
- Trying to "fix" projects that are having trouble staying on-target
- Sharing new ideas about how to coordinate our efforts better
- Finding ways to improve our management of projects
The goal of this live IRC chat is to provide a regular forum to resolve tricky issues that benefit from real-time, "live" discussion. Generally, this meeting should last no more than one hour if possible. Generally, new ideas and practices should be discussed in this live meeting, with the list being used for status updates and coordinated resolution of critical issues.
Inability to attend due to time zone can be addressed by posting the full IRC log to gentoo-managers and allowing non-attending members to post ideas, comments and follow-ups.
Every Thursday afternoon, every member of this list posts a "status update" email, giving all members a quick, general update on any efforts currently underway. This allows for some fairly rapid feedback for any efforts that were started the previous Monday, and an opportunity to recover from any efforts that have fallen off-target since the previous Monday.
This email need not be exhaustive, but may be if necessary.
The goal of this update is to allow any problems with our projects to be discussed and shared before the weekend, so that an adequate solution or interim solution can be found before the weekend.
Top-level projects and preliminary top-level managerial assignments below. Note that sub-project managers are generally not listed, but will be defined in time. We are starting with the top levels first, then recursing downwards.
Code Listing 3.1: Management heiarchy
gentoo-linux: Gentoo Linux strategic manager: drobbins, seemant operational manager: seemant back-up: avenj sub-projects: x86-stable: Gentoo Linux x86 stable branch x86-unstable: Gentoo Linux x86 unstable branch amd64 ppc alpha sparc hppa etc.
kernel: Kernel development strategic manager: pfeifer (lolo?) operational manager: pfeifer (lolo?) sub-projects: x86 amd64 ppc alpha sparc hppa etc.
gentoo-alt: Alternate operating system platform/special-purpose projects strategic managers: drobbins, pvdabeel operational manager: pvdabeel sub-projects: gentoo-bsd gentoo-macos livecd: Gentoo Linux LiveCD technology efforts
hardened: Hardened Gentoo -- efforts related to integrated security techologies into Gentoo Linux. strategic manager: method operational manager: method page: http://www.gentoo.org/proj/en/hardened/ sub-projects: selinux propolice systrace hardened-sources grsecurity
tools: Useful Gentoo scripts and tools (for user or developer use, possibly Portage-related) strategic manager: pvdabeel operational manager: pvdabeel subprojects: keychain dynfw eperl
devrel: General development management, developer relations strategic managers: seemant, drobbins operational manager: avenj back-up: klieber subprojects: newdev: Recruiting of developers, enforcement of recruitment policy devops: Day-to-day oversight of Gentoo development, commits
releng: Managing and coordinating release process strategic manager: drobbins, seemant operational manager: avenj subprojects: build: Management of stage/package building efforts on all architectures install-doc: install documentation
qa: Explicit, proactive quality control efforts strategic manager: drobbins operational manager: seemant subprojects: bugs: Overseeing bug distribution/assigment/completion and responsiveness security: Manage tracking and application of security fixes to packages policy-doc: policy documentation
pr: Public relations efforts, contact with distrowatch.com, etc. strategic manager: drobbins operational manager: klieber back-up: seemant subprojects: partners: Gentoo partnerships, liaison(s) to metapkg, Gentoo Games, Inc. shows: Planning and organization for trade shows gwn: Gentoo Weekly News
portage: Portage development, maintenance and new features implementation strategic manager: drobbins operational manager: carpaski subprojects: package-research: Research into new packaging technologies and capabilities managers: carpaski, drobbins, pvdabeel
infrastructure: strategic manager: klieber operational manager: klieber gentoo.org Mirrors, servers, email, hosting, server security subprojects: mirrors: ftp, web and rsync mirrors web: gentoo.org Web site design and related technology doc: general documentation