Question: How high is the risk to a project should the most active people leave?
The Bus Factor is a compelling metric because it visualizes the question "how many contributors can we lose before a project stalls?" by hypothetically having these people get run over by a bus (more pleasantly, how many would have to win in a lottery and decide to move on).
The Bus Factor is the smallest number of people that make 50% of contributions.
- Identify how widely the work in a project is distributed across contributors.
- Identify the key people in a project that are doing the majority of the work.
The usage and dissemination of health metrics may lead to privacy violations. Organizations may be exposed to risks. These risks may flow from compliance with the GDPR in the EU, with state law in the US, or with other law. There may also be contractual risks flowing from terms of service for data providers such as GitHub and GitLab. The usage of metrics must be examined for risk and potential data ethics problems. Please see CHAOSS Data Ethics document for additional guidance.
The formula for Bus Factor is a percentage calculation -50% will be our threshold- followed by adding up each contributor's contributions sorted in decreasing order until we reach the threshold.
If we have 8 contributors who each contribute the following number of contributions to a project:
1000, 202, 90, 33, 332, 343, 42, 433, then we can determine the Bus Factor by first identifying the 50% of total contributions for all the contributors.
Summary: 50% of total contributions =
1,237.5, so the Bus Factor is
- Arrange the data in descending order:
1000, 433, 343, 332, 202, 90, 42, 33
- Compute the 50% of the total:
(1,000 + 433 + 343 + 332 + 202 + 90 + 42 + 33) * 0.5 = 1,237.5
- Adding up the first two contributors in our ranking we get
- Answer: as
1,433 > 1,237.5, more than the 50% of contributions is performed by only
2contributors, thus the
Bus Factor = 2.
- Time: The Bus Factor may be vary for different time periods. The Bus Factor over the life of a project may misrepresent the current level of contributor engagement in the project.
- Repository Group: Many open source projects include multiple repositories, and in some cases examining all of the repositories associated with any given project provides a more complete picture of the Bus Factor.
The Bus Factor for the CHAOSS Project in 2020, when considering only git commits, was 5.
Tools Providing the Metric
- GrimoireLab provides this metric out of the box, not as a single number but as a visualization.
Data Collection Strategies
The data collection strategy depends on the Types of Contributions used for calculating the Bus Factor. Bus Factor is often calculated for commits but other types of contributions can be used for this as well, separately or combined.