oss-health-metrics:metric-template
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
|
oss-health-metrics:metric-template [2017/04/19 18:33] abuhman |
oss-health-metrics:metric-template [2017/05/18 00:11] GeorgLink [{Name of Metric}] add back-link |
||
|---|---|---|---|
| Line 2: | Line 2: | ||
| The following is a draft for the template that all 'Metric Detail' pages can follow. | The following is a draft for the template that all 'Metric Detail' pages can follow. | ||
| - | The template is inspired by the [[https://istheory.byu.edu/wiki/Signaling|IS Theories Wiki]]. | + | The template is inspired by the __[[https://istheory.byu.edu/wiki/Signaling|IS Theories Wiki]]__. |
| ===== Instructions ===== | ===== Instructions ===== | ||
| Line 8: | Line 8: | ||
| To create a new 'Metric Detail' page follow these steps: | To create a new 'Metric Detail' page follow these steps: | ||
| - | - In the [[oss-health-metrics:metrics|metrics list]], convert the name of a metric into a link | + | - In the __[[oss-health-metrics:metrics|metrics list]]__, convert the name of a metric into a link |
| - | - The link looks like this: ''%%[[oss-health-metrics:metrics:name-of-metric|Name of Metric]]%%''. | + | - The link looks like this: ''%%__[[oss-health-metrics:metrics:name-of-metric|Name of Metric]]__%%''. |
| - **Important:** The namespace ''oss-health-metrics:metrics:'' places the page in the right location of the wiki and has to be there. | - **Important:** The namespace ''oss-health-metrics:metrics:'' places the page in the right location of the wiki and has to be there. | ||
| - Before the verticle bar, the //Name of Metric// should be lower case and spaces replaced by hyphens. | - Before the verticle bar, the //Name of Metric// should be lower case and spaces replaced by hyphens. | ||
| Line 19: | Line 19: | ||
| ---- | ---- | ||
| + | __**[[oss-health-metrics:metrics|<< Back to List of Activity Metrics]]**__ | ||
| ====== {Name of Metric} ====== | ====== {Name of Metric} ====== | ||
| - | ===== 1. Acronym ===== | ||
| - | The metric might be known by a short name or acronym. | ||
| - | ===== 2. Alternate Names ===== | + | ===== 1. Description ===== |
| - | 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/Viability/Risk, or generic/composite metric | + | |
| - | + | ||
| - | ===== 4. Description ===== | + | |
| A description of what the metric is and what it captures. | A description of what the metric is and what it captures. | ||
| + | The first few sentences have to match the description in the [[oss-health-metrics:metrics||metrics list]]. | ||
| - | ==== Pseudo Code ==== | + | ===== 2. Use Cases ===== |
| + | Provide examples of how the metric might inform different stakeholders through use cases. | ||
| - | ==== Visualization ==== | + | ===== 3. Sample Visualization ===== |
| + | Include a sample visualization (screenshot) of the metric from any implementation. | ||
| - | Include a sample visualization (screenshot) of the metric | + | ===== 4. Sample Implementation ===== |
| - | ==== Interpretation ==== | + | |
| - | Provide examples of how the metric might inform different stakeholders. | + | |
| - | + | ||
| - | ===== 5. Example Implementation ===== | + | |
| A generic calculation (code) or SQL query that generates the metric. | A generic calculation (code) or SQL query that generates the metric. | ||
| - | ===== 6. Data Exchange Format ===== | + | ===== 5. Known Implementations ===== |
| - | Describe how the metric is encoded for sharing and communicating between programs. | + | |
| - | + | ||
| - | ===== 7. 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). | 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). | ||
| - | ===== 8. References to Academic Literature ===== | + | ===== 6. External References (Literature) ===== |
| - | Papers released in the academic literature that uses the metric. | + | Blog posts, websites, academic papers, or books that mention the metric. |
| - | + | ||
| - | ===== 9. Internet References ===== | + | |
| - | Links to websites that add value to the understanding of the metric. | + | |
| - | + | ||
| - | ===== 10. Contributors ===== | + | |
| - | Authors of the metric page and authors who made significant changes. | + | |
oss-health-metrics/metric-template.txt · Last modified: 2017/10/06 21:00 by GeorgLink
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International
