├── .github ├── CONTRIBUTING.md └── FUNDING.yml ├── LICENSE ├── README.md ├── RELEASING.md └── resources ├── checklist-quality.md └── metrics-template.md /.github/CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | # How to Contribute 2 | 3 | See the CHAOSS [CONTRIBUTING.md][contrib] for details. 4 | 5 | [contrib]: https://github.com/chaoss/governance/blob/master/CONTRIBUTING.md 6 | 7 | ## How to become a repository maintainer 8 | Maintainers are responsible and capable for accepting pull requests. 9 | We strive to have three maintainers and a new maintainer may replace a current maintainer. 10 | Current maintainers identify a new maintainer based on engagement in issues, pull-requests, and other community engagement related to this repository. 11 | 12 | 13 | ## Additional Resources 14 | 15 | * [CHAOSS Website][chaoss] 16 | * [CHAOSS Metrics Wiki][wiki] 17 | 18 | 19 | [chaoss]: https://chaoss.community/ 20 | [wiki]: https://wiki.linuxfoundation.org/chaoss/metrics 21 | -------------------------------------------------------------------------------- /.github/FUNDING.yml: -------------------------------------------------------------------------------- 1 | # These are supported funding model platforms 2 | 3 | github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2] 4 | patreon: # Replace with a single Patreon username 5 | open_collective: chaoss 6 | ko_fi: # Replace with a single Ko-fi username 7 | tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel 8 | community_bridge: # Replace with a single Community Bridge username 9 | liberapay: # Replace with a single Liberapay username 10 | issuehunt: # Replace with a single IssueHunt username 11 | otechie: # Replace with a single Otechie username 12 | custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2'] -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2017 CHAOSS Project 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining 6 | a copy of this software and associated documentation files (the "Software"), 7 | to deal in the Software without restriction, including without limitation 8 | the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or 9 | sell copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in 13 | all copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, 16 | INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A 17 | PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT 18 | HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 19 | OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 20 | SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 21 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # CHAOSS Metrics 2 | 3 | Welcome to the CHAOSS Metrics repository. CHAOSS Metrics work captures metrics for open source community health more transparent and actionable. 4 | 5 | ## Current CHAOSS Metrics Release 6 | The current release of CHAOSS metrics can be found at: https://chaoss.community/metrics/. 7 | 8 | ## Working on CHAOSS Metrics 9 | 10 | The current release of CHAOSS metrics represents the published work being done by CHAOSS Metrics Working Groups. The work in the WGs does not necessarily coincide with the formally releases metrics as the WGs are developing new, yet-to-be-released metrics. 11 | 12 | Work being done in the CHAOSS WGs can be found at: 13 | 14 | [CHAOSS Common Metrics Working Group](https://github.com/chaoss/wg-common) 15 | 16 | [CHAOSS Diversity & Inclusion Working Group](https://github.com/chaoss/wg-diversity-inclusion) 17 | 18 | [CHAOSS Evolution Working Group](https://github.com/chaoss/wg-evolution) 19 | 20 | [CHAOSS Value Working Group](https://github.com/chaoss/wg-value) 21 | 22 | [CHAOSS Risk Working Group](https://github.com/chaoss/wg-risk) 23 | 24 | ## Metrics Resources 25 | 26 | [Metrics Template](resources/metrics-template.md) 27 | 28 | ## Contribute and Participate to the CHAOSS Project and Metrics Working Groups 29 | 30 | [Contribute and Participate](https://chaoss.community/participate/). 31 | 32 | ## Repository Maintainers 33 | 34 | - [Dawn Foster](https://github.com/geekygirldawn) 35 | - [Georg Link](https://github.com/GeorgLink) 36 | - [Matt Germonprez](https://github.com/germonprez) 37 | - [Ben Lloyd Pearson](https://github.com/BenLloydPearson) 38 | 39 | [How to become a maintainer](.github/CONTRIBUTING.md#how-to-become-a-repository-maintainer) 40 | 41 | # License 42 | 43 | All contributions to implementation-agnostic metrics and standards, including associated scripts, SQL statements, and documentation, will be received and made available under the MIT License (https://opensource.org/licenses/MIT). 44 | -------------------------------------------------------------------------------- /RELEASING.md: -------------------------------------------------------------------------------- 1 | ## RELEASING CHAOSS METRICS 2 | 3 | This document provides requirements for releasing CHAOSS metrics. Below defines the necessary steps: 4 | 5 | 1. Metrics must be associated with a CHAOSS working group 6 | 2. Metrics must be associated with a working group's focus area 7 | 3. Metrics must have an associated question that is being addressed 8 | 4. Metrics must have an associated detail page providing more information about the metric. Examples: 9 | * https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors.md 10 | * https://github.com/chaoss/wg-diversity-inclusion/blob/master/focus-areas/governance/board-council-diversity.md 11 | 5. Metrics must be consistently referenced across the CHAOSS organization. This typically includes (1) the name/question listing in the focus area, (2) the name/question listing on the detail page, and (3) name/question listing in the aggregate metric list at: https://github.com/chaoss/metrics 12 | 6. Metrics must be identified as 'ready for release' in the following spreadsheet: 13 | * https://docs.google.com/spreadsheets/d/1_jwkwzs8s6SAm2vVY-8lzTQk3YT0YpOveTlKOwjd2eQ/edit#gid=0 14 | 15 | Once these criteria are met, open an issue at: https://github.com/chaoss/metrics indicating the working group and metrics for release. 16 | -------------------------------------------------------------------------------- /resources/checklist-quality.md: -------------------------------------------------------------------------------- 1 | This issue is created to collect comments about the rolling release of "______" 2 | 3 | This metric can be found here: https://github.com/chaoss/xxxxxxx/xxxxxxx/xxxxxxx.md 4 | 5 | See all release candidates: https://chaoss.community/metrics/ 6 | 7 | ## CHAOSS Metric Quality Checklist 8 | This checklist is used for new and updated metrics to ensure we follow CHAOSS quality standards and processes. Below checklist items don’t have to be completed all at once: create the metric release candidate issue first and then start working on the checklist. 9 | 10 | ### Process 11 | 12 | - [ ] Create the “review issue” in the authoring WG’s repo for comments during review period and paste this template in 13 | - [ ] Create pull request to edit or add metric to WG’s repo (after checking Content Quality and Technical Requirements below) 14 | - [ ] Add the new metric or metric edit to release notes issue in working group repo 15 | - [ ] Update the [Metrics Spreadsheet](https://docs.google.com/spreadsheets/d/1tAGzUiZ9jdORKCnoDQJkOU8tQsZDCZVjcWqXYOSAFmE/edit) 16 | - [ ] Create issue in [CHAOSS/Translations repository](https://github.com/chaoss/translations) to kick-off translation to other languages (please use the the translation issue template) 17 | - [ ] "Metric Candidate Release" label added to the metric release candidate issue. 18 | - [ ] Metric was added to website 19 | 20 | **When above steps are completed:** 21 | 22 | - [ ] Announce new/updated metric on mailing list, newsletter, community Zoom call, and Twitter. This can be coordinated with the community manager. 23 | 24 | ### Content Quality 25 | 26 | - [ ] Required headings are filled in, including Questions. 27 | - [ ] Description provides context to metric 28 | - [ ] Objectives list sample uses for the metric and desired outcomes 29 | - [ ] If any, DEI uses of the metric are included in Objectives 30 | - [ ] Optional headings that have no content were removed 31 | - [ ] Contributors section lists those contributors that want to be named 32 | - [ ] The name of the metric is the same in (1) metric heading, (2) metric file name, (3) focus area, (4) metrics spreadsheet, (5) “review issue”, (6) translation issue, and (7) website 33 | 34 | ### Technical Requirements 35 | 36 | - [ ] Message in the metric markdown file that the metric will be part of the next regular release is at top of page and the links are correct (this is in the [metric template](https://github.com/chaoss/metrics/blob/master/resources/metrics-template.md)) 37 | - [ ] Metric file name is the full metric name and only contains lower case letters and hyphens (“-”) for spaces 38 | - [ ] Images are included using markdown and relative links (as described in the metrics template) 39 | - [ ] Images have at least one empty line above and below them 40 | - [ ] Ensure images are placed in image folder and followed [naming convention](https://github.com/chaoss/metrics/blob/master/resources/metrics-template.md) 41 | - [ ] If new focus area is created, ensure focus area is added to wg repo readme and focus area folder readme 42 | - [ ] Within the focus area, add the metric in the table and provide the link to the metric and metric question 43 | - [ ] Ensure tables within metric are converted as image and placed in the image folder (both original MD and screenshotted PNG format) and follow the naming convention 44 | - [ ] No HTML code in the metrics markdown file 45 | 46 | 47 | 48 | 49 | -------------------------------------------------------------------------------- /resources/metrics-template.md: -------------------------------------------------------------------------------- 1 | # {Name of Metric} 2 | 3 | ### This metric is a release candidate. To comment on this metric please see Issue [#[put the respective Issue Number here]](URL to issue). Following a comment period, this metric will be included in the next regular release. 4 | 5 | Question: 6 | 7 | Synonyms: [Known synonyms for the metric - only common synonyms - this not meant to be a diffinitive list] 8 | 9 | ## Description 10 | A description of what the metric is and what it captures. 11 | 12 | ## Objectives 13 | Answer the question for why someone wants to measure this metric and what can be known with it. 14 | 15 | [Each metric has the potential to influence diversity, equity, and inclusion on an open source project. Please consider these factors when framing metrics objectives.] 16 | 17 | ## Implementation 18 | __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__ 19 | 20 | Provide details on how to measure the metric, collect the data, and analyze it. The following sub-headings are optional but help to structure the different aspects of implementation. 21 | 22 | ### Filters (optional) 23 | Include a Filter 24 | 25 | ### Visualizations (optional) 26 | Include visualizations such as screenshot of the metric. There may be many more visualizations for this metric, we only want to provide a flavor for what this metric is about. 27 | 28 | Please provide attribution where the screenshot was taken, e.g. what software. 29 | 30 | ### Tools Providing the Metric (optional) 31 | Metric must be currently deployed/available, in contrast to a tool having the "potential" to provide the metric. Provide direct link to implementation/documentation, if applicable 32 | 33 | ### Data Collection Strategies (Optional) 34 | If there are several different ways to collect data for this metric, list them here. 35 | This may include expressing a metric in different ways. 36 | 37 | ## References 38 | Blog posts, websites, academic papers, or books that mention the metric and provide more background. 39 | 40 | ## Contributors 41 | List of people who would like to be mentioned as contributors to this metric 42 | ``` 43 | 44 | ***This metric was last reviewed on [date] as part of [ release version ] [or recurring review process]*** 45 | 46 | -------- 47 | # Notes about document formatting 48 | ***The following rules are applicable for the above defined metric template:*** 49 | * Metrics naming - In cases where the metric name is also a descriptor, please use this convention: 50 | 51 | "specific thing being measured"-"further description if needed" 52 | 53 | EX: `pull-requests-open.md` 54 | EX: `issues-first-response.md` 55 | 56 | * Please provide attribution for where the image was taken, e.g. what software. 57 | * All the images should be using the markdown syntax: `![]()` 58 | * All the images should be using an absolute path to the images directory (Absolute paths are necessary, becuase these documents will be presented on a different platform/server). 59 | * Eg. `![alt text](https://github.com/chaoss/working-group/focus-area//images/metric-name_img.png)` 60 | * No tables should be used in the metrics, alternatively you can insert an image of the table 61 | * No HTML code should be used in the metrics, only markdown 62 | * Please remove formatting text and (Optional) tags from the metric prior to publishing 63 | * There should be at least one `\n` (newline) between: 64 | * 2 images 65 | * An image and text 66 | * An image and heading \ 67 | This is to solve the wrapping issue in the release PDF \ 68 | Eg. - 69 | ``` 70 | # Some heading 71 | 72 | ![alt text](images/metric-name_test-img1.png) 73 | 74 | ![alt text](images/metric-name_test-img2.png) 75 | 76 | * Some random text 77 | 78 | ![alt text](images/metric-name_test-img3.png) 79 | 80 | Another text line 81 | ``` 82 | --------------------------------------------------------------------------------