What is open source project governance? | Opensource.com

What is open source project governance?

Clearly defining roles and responsibilities is essential to effective open source community management. Here are some ways to help you organize.

Collaboration starts with communication amongst teams and across silos
Image credits : 

Subscribe now

Get the highlights in your inbox every week.


So what exactly is open source project governance?



Defining governance

The above definition of governance is still a bit general, though, so let's get more specific. When you define governance for a project, you need to identify the following five things:

  1. What roles can contributors play in the project?
  2. What qualifications, duties, privileges, and authority are associated with each role?
  3. How do people get assigned to (and removed from) roles?
  4. How can role definitions be changed?
  5. What are the project's collected policies and procedures?

A good deal of activity in open source communities hinges on project roles. Every community has roles its contributors play, but, unfortunately, many projects don't formally define those roles and their responsibilities. Think of roles as the "jobs" each project participant has. One contributor can have more than one role, and many roles are shared by multiple contributors.

For example, "Lead Code Maintainer" is a role, as is "New Contributor" or "Meetup Organizer." While these roles are not written down, they're implicit in activities people are already engaged in (and potentially a source of argument). So the process of defining governance for a project is mostly the process of documenting roles, both the existing ones and the ones that the project should/will create.

Know your role

As an example, a governance document might define the role of "Documentation Maintainer," which could be generally described this way:

  • Qualifications: several years contributing to documentation
  • Duties: write documentation and review other people's documentation
  • Privileges: speak for the documentation team, participate in development meetings
  • Authority: decide on document content, production toolchain, and strategy
  • Change procedure: all existing Documentation Maintainers vote on role changes

In reality, written role descriptions are much more detailed and explicit than that (some projects' formal role descriptions can run a dozen pages or more).

Additionally, some roles are collective—more about groups than individuals—and certain policies and procedures might apply to those collective roles. For example, there might be a "steering committee election procedure" that defines duties and privileges. And, of course, a code of conduct usually applies to all roles in the project.

This is where policies and procedures become important. Documented well, they explain how specific activities are supposed to be carried out by groups of roles. But they don't stand on their own; they require role descriptions in order to make sense. For example, imagine you want to write the election procedure for your steering committee. Before you can do that, you need to define both who is a voting member of the project and what steering committee members do.

Large open source projects can feature dozens or hundreds of potentially defined roles, particularly since each role will often have sub-roles as well. In Kubernetes, for instance, the role of Code Contributor is subdivided by Special Interest Group (SIG) and by contributor level (member, reviewer, approver, and owner). So someone's actual role is going to be "SIG-Network Approver," not just Code Contributor. Smaller projects, on the other hand, should define fewer roles and make their descriptions more general.

Getting started

If your open source project or community's governance model is evolving—or if you're documenting or formalizing it for the first time—the community should ask itself the following questions to generate productive discussion:

  • What roles do project contributors play in this community?
  • Are these roles clearly defined or described?
  • Are those role definitions or descriptions accessible to everyone working on the project?
  • Do these role descriptions also explain how contributors can take on or leave the roles?

The questions seem straightforward—but the answers you'll receive are likely more complex than you anticipated.

This article is adapted from The Open Source Way project.

Typewriter with hands

Mixing experienced tech writers with open source communities reveals new approaches for creating better docs.

About the author

Josh Berkus headshot
Josh Berkus - Josh Berkus helps manage the Kubernetes community for Red Hat.  A new container stack enthusiast, he also works with Docker, Atomic Host, Buildah, Etcd and other projects.  He is also a former maintainer of the PostgreSQL database system, and as such is perpetually interested in running databases on Kubernetes.  He lives in Portland with a spouse, a startlingly large black cat, and way too much cookware.