CHAOSS workgroup focused on Diversity and Inclusion metrics
Clone or download
Latest commit baa50f5 Dec 16, 2018

What is this working group about?

This working group aims at bringing experiences measuring diversity and inclusion in open source projects.

Join our Mailing List

Upcoming meetings


Its main goal focuses on understanding from a qualitative and quantitative point of view how diversity and inclusion can be measured. This will bring four main outcomes:

  • First a set of metrics curated by the community focused on understanding and measuring diversity
  • Second learn good practices from open source communities on improving their diversity and inclusion
  • Third produce useful software to measure diversity from a quantitative point of view. This is expected to produce generic software to analyze several repositories of information such as Git repositories or Mailing lists
  • Fourth, good practices on how to deal with such data, maintain and ways of collaboration with open source communities.
  • Fifth, a method that other communities can reproduce the report for themselves.

An example of the expected outcomes is the OpenStack Gender Report that focuses on the analysis of the gender-diversity in the OpenStack Foundation. This project sponsored by Intel and Bitergia aims at helping the community with data. And we need data to make decisions!

This project is under the CHAOSS project that is part of The Linux Foundation, with participation from multiple other organizations and institutions (see contributors list).

As the CHAOSS project consists of two Technical Committees: Software and Metrics, this project aims at working closely with both and learn their best practices. In addition, this working group expects to discuss new ideas in terms of metrics and software with both committees improving the knowledge base around this topic.

Note: We want to make our tools and report inclusive globally.

What we are currently working on

  • We are prototyping a structure that we want to create our metrics and recommendations for a D&I report in. Current draft is in this google doc
    • Please leave comments and suggest edits where needed
  • Next up: We want to walk through the structure and prototype our first resource pages at the Open Source Summit North America 2018 on August 29th. -- If you are interested, watch the CHAOSS mailing list for details on when and where we meet.


  • Integrate results with the general Metrics group
    • Write down all of the goal-question-metric ideas we have in this document
    • #14 Migrate Google Docs D&I GQM approach to this repository
  • Validate with experts in the field.
  • Produce reusable outcomes by third parties when measuring D&I
    • #15 Create a method that other communities can reproduce the report for themselves
  • Dissemination of the results across several communities
    • Open Source Summit NA / Europe
    • OSCON
    • CHAOSScon NA
    • Others

Metrics Focus Areas

We are compiling dimensions of diversity and inclusion that can be used in the following areas of analysis:

Focus Area Goal
1. Event Diversity Identify the diversity and inclusion at events.
2. Contributor Community Diversity Identify the diversity of the contributions within a community, and howe those different contributions are valued.
3. Communication Inclusivity Identify how we are communicating with contributors, and potential contributors.
4. Recognition of Good Work Identify how we recognize/reward good work in our community.
5. Leadership Identify how healthy our community leadership is.
6. Governance Identify how diverse and inclusive our governance is.
7. Project and Community Identify how diverse and inclusive our project places, where community engagement occurs, are.

Each area lists a collection of relevant questions. If you are interested in answering a question for your community, go to the associated resource page where we collect strategies for answering the question.

Software Work

To be done

How can you help?

This project is open to anyone interested in the topic of diversity and inclusion. And this includes several areas of work such as diversity and inclusion from a broader perspective, mining software repositories, Python development, tech writing, people interested in speaking at events and others.

The collaboration guide is still in progress, but a first good step would be to introduce yourself at the CHAOSS mailing list explaining a bit your interest.

Most of the work in the metrics side will be done through pull requests to the markdown files containing discussions about the metrics used or to be used. This is the same method as when updating the software side of the project.



Core Contributors

The criteria for becoming a core contributor is to participate at least once per month over a period of 3 months. Participation could include providing feedback in the weekly D&I meetings, providing feedback on docs, or making other contributions on GitHub (commits / issues). People not participating over a 3 month period may be removed as core contributors.

If you'd like to be on our squad, an easy way to start is by going through the issue list and fixing some. 🎉

All Contributors Ordered by first name

Akshita Gupta, Alexander Serebrenik, Brian Proffitt, Chris Clark, Daniel Izquierdo Cortazar, Dawn Foster, Drashti, Emma Irwin, Georg Link, Jaice Singer Du Mars, Joshua R. Simmons, Kevin Lumbard, Laura Gaetano, Luis Villa, Matt Germonprez, Nicole Huesman, Rupa Dachere, Shreyas

Are you eligible to be on this list? You are if you helped in any capacity, for example: Filed an issue. Created a Pull Request. Gave feedback on our work. The team will try to update this list monthly, but please open an issue or post on the mailing list if we've missed anyone.

If you find yourself missing, please create a pull request or reach out to a maintainer. We started to maintain this list after starting the workgroup and are likely missing some of you. If you find yourself listed here and want to be removed, please create a pull request or ask a maintainer.

Related Works

Collection of initiatives and related works that can inform our work or that we can collaborate with.