User Tools

Site Tools


oss-health-metrics:metric-template

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
oss-health-metrics:metric-template [2017/03/20 16:59]
GeorgLink remove curly brackets, added section numbers
oss-health-metrics:metric-template [2017/10/06 21:00] (current)
GeorgLink fixed link
Line 1: Line 1:
 ====== Template for Metric ====== ====== Template for Metric ======
-The following is a draft for the template that all metric detail pages can follow. +Page permanently moved to  
- +https://github.com/chaoss/metrics/blob/master/activity-metrics/metric-template.md
-The template is inspired by the [[https://istheory.byu.edu/wiki/Signaling|IS Theories Wiki]]. +
- +
----- +
- +
-====== Name of Metric ====== +
-(No text in this section - remove this text.) +
- +
-===== 1. Acronym ===== +
-The metric might be known by a short name or acronym. +
- +
-===== 2. Alternate Names ===== +
-Some metrics ​might be known by different names, e.g. bus factor and truck factor. +
- +
-===== 3. Classification ===== +
-Classifications might include: Community/Code/Risk, or Activity/Vaiability/Risk, or generic/​composit ​metric +
- +
-===== 4. Description ===== +
-A description of what the metric is and what it captures. +
- +
-===== 5. Interpretation ===== +
-Provide examples of how the metric might inform different stakeholders. +
- +
-===== 6. Known Implementations ===== +
-Examples of where and how metric is used. (include links to dashboard or location where metric is visible or is talked about having been used). +
- +
-===== 7. Data Source ===== +
-The orginal data source or other metric this one is building on. +
- +
-===== 8. Code/Query ===== +
-The calculation (code) or SQL query that generates the metric. +
- +
-===== 9. References to Academic Literature ===== +
-Papers released in the academic literature that uses the metric. +
- +
-===== 10. Internet References ===== +
-Links to websites that add value to the understanding of the metric. +
- +
-===== 11. Contributors ===== +
-Authors of the metric page and authors who made significant changes.+
oss-health-metrics/metric-template.1490029159.txt.gz · Last modified: 2017/03/20 16:59 by GeorgLink