Merge branch 'master' into rrrutledge-patch-1

Author: rrrutledge

measuring/gqm_example/README.md

@@ -4,7 +4,7 @@ See the ["Metrics" section of CONTRIBUTING.md](../../CONTRIBUTING.md#metrics).
 
 # What Is The Goal Question Metric (GQM) Example?
 
-The GQM example is a starting point to create additional Goals, Questions, and Metrics relevant to an InnerSource Program Office (ISPO)
+The GQM example is a starting point to create additional Goals, Questions, and Metrics relevant to an InnerSource Program Office (ISPO).
 
 ## Stakeholder Use Cases
 

measuring/use_gqm.md

@@ -2,26 +2,31 @@
 
 *An overview of the Goals, Questions, and Metrics (GQM) catalog.*
 
+This page works better in GitHub; [click here](https://github.com/InnerSourceCommons/managing-inner-source-projects/blob/master/measuring/use_gqm.md).
+
 ```mermaid
 graph LR;
-find-projects[Find Projects] --> who-uses[Who Uses];
-reduce-duplication[Reduce Duplication] --> who-uses[Who Uses];
-who-uses --> usage-count[Usage Count];
-find-projects --> who-contributes
-who-contributes[Who Contributes] --> code-contributions[Code Contributions];
+    subgraph GQM[Goals, Questions, Metrics]
+        find-projects[<a href='https://github.com/InnerSourceCommons/managing-inner-source-projects/blob/master/measuring/goals/find-projects.md'>Find Projects</a>] --> who-uses[Who Uses]
+        reduce-duplication[<a href='https://github.com/InnerSourceCommons/managing-inner-source-projects/blob/master/measuring/goals/reduce-duplication.md'>Reduce Duplication</a>] --> who-uses[<a href='https://github.com/InnerSourceCommons/managing-inner-source-projects/blob/master/measuring/questions/who-uses.md'>Who Uses</a>]
+        who-uses --> usage-count[<a href='https://github.com/InnerSourceCommons/managing-inner-source-projects/blob/master/measuring/metrics/usage-count.md'>Usage Count</a>]
+        find-projects --> who-contributes
+        who-contributes[<a href='https://github.com/InnerSourceCommons/managing-inner-source-projects/blob/master/measuring/questions/who-contributes.md'>Who Contributes</a>] --> code-contributions[<a href='https://github.com/InnerSourceCommons/managing-inner-source-projects/blob/master/measuring/metrics/code-contributions.md'>Code Contributions</a>]
+    end
+    subgraph Legend
+        direction TB
+
+        goal[Goal]
+        question[Question]
+        metric[Metric]
+
+        classDef goals stroke:green,stroke-width:2px;
+        class goal,find-projects,reduce-duplication goals
+
+        classDef questions stroke:orange,stroke-width:2px;
+        class question,who-uses,who-contributes questions
+
+        classDef metrics stroke:purple,stroke-width:2px;
+        class metric,code-contributions,usage-count metrics
+    end
 ```
-
-## Goals
-
-* [Find Projects](../goals/find_projects.md)  
-* [Reduce Duplication](../goals/reduce_duplication.md)  
-
-## Questions
-
-* [Who contributes to the InnerSource project?](../questions/who-contributes.md)
-* [Who uses the InnerSource project?](../questions/who-uses.md)
-
-## Metrics
-
-* [Code Contributions](../metrics/code-contributions.md)
-* [Usage Count](../metrics/usage_count.md)