This is an old revision of the document!
The following is a draft for the template that all 'Metric Detail' pages can follow.
The template is inspired by the IS Theories Wiki.
To create a new 'Metric Detail' page follow these steps:
[[oss-health-metrics:metrics:name-of-metric|Name of Metric]]
.oss-health-metrics:metrics:
places the page in the right location of the wiki and has to be there. The metric might be known by a short name or acronym.
Some metrics might be known by different names, e.g. bus factor and truck factor.
Classifications might include: Community/Code/Risk, or Activity/Viability/Risk, or generic/composite metric
A description of what the metric is and what it captures.
Include a sample visualization (screenshot) of the metric
Provide examples of how the metric might inform different stakeholders.
A generic calculation (code) or SQL query that generates the metric.
Describe how the metric is encoded for sharing and communicating between programs.
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).
Papers released in the academic literature that uses the metric.
Links to websites that add value to the understanding of the metric.
Authors of the metric page and authors who made significant changes.