fix: add index.md to clean urls

Author: jeffabailey

SUMMARY.md

@@ -10,24 +10,24 @@
   * [Comparing How Inner-Sourced Your Infra Is](infrastructure/assessment.md)
   * [Authors and Reviewers](infrastructure/authors.md)
 * [What, When and How to Measure](measuring/measuring.md)
-  * [Goals using Metrics](measuring/goals.md)
+  * [Goals using Metrics](measuring/goals_using_metrics.md)
     * [Use Goals, Questions, and Metrics](measuring/use_gqm.md)
-      * [Goals](measuring/goals.md)
+      * [Goals](measuring/goals/index.md)
         * [Find InnerSource Projects](measuring/goals/find-projects.md)
         * [Reduce Duplication](measuring/goals/reduce-duplication.md)
-      * [Questions](measuring/questions.md)
+      * [Questions](measuring/questions/index.md)
         * [What is the InnerSource Adoption Trend?](measuring/questions/adoption-trend.md) 
         * [Who contributes to the InnerSource project?](measuring/questions/who-contributes.md)
         * [Who Uses](measuring/questions/who-uses.md)
-      * [Metrics](measuring/metrics.md)
+      * [Metrics](measuring/metrics/index.md)
         * [Code Contributions](measuring/metrics/code-contributions.md)
         * [Contribution Distance](measuring/metrics/contribution-distance.md)
         * [Number of InnerSource repositories](measuring/metrics/number-of-innersource-repositories.md)
         * [Usage Count](measuring/metrics/usage-count.md)
   * [Areas of Analysis](measuring/areas.md)
   * [Goal-Question-Metric Approach](measuring/gqm.md)
   * [Strategy](measuring/strategy.md)
-  * [Examples of Interest](measuring/metrics.md)
+  * [Examples of Interest](measuring/examples.md)
   * [References](measuring/references.md)
   * [Authors and Reviewers](measuring/authors.md)
 * [Governance](governance/governance.md)

measuring/examples.md

@@ -0,0 +1 @@
+# Examples of Interest

measuring/goals/index.md

@@ -0,0 +1,21 @@
+# InnerSource Goals
+
+This directory contains the goals for measuring InnerSource success. Each goal is defined using the Goal-Question-Metric (GQM) approach.
+
+## Available Goals
+
+1. [Find InnerSource Projects](find-projects.md)
+   - Make it easy for people to discover and use InnerSource projects
+   - Focuses on project discoverability and usage
+
+2. [Reduce Duplication](reduce-duplication.md)
+   - Minimize redundant development efforts across the organization
+   - Encourages building software once and sharing it widely
+
+## Templates
+
+- [GQM Goal Template](gqm_goal_template.md) - Template for creating new goals using the GQM approach
+
+## Related Resources
+
+- [Back to the overall graph](../use_gqm.md)

measuring/goals_using_metrics.md

@@ -0,0 +1,47 @@
+Goals using Metrics
+===================
+
+This section aims at providing a strategy for your InnerSource metrics
+that help to understand the path from your initial process till a full
+InnerSource organization.
+
+It is important to remark that metrics useful for some organizations are
+not that useful in other contexts. This is similar to the open source
+projects where a project is not that similar to other in terms of
+governance, licenses, infrastructure or detailed process, but they are
+producing open source software and working as a community. This handbook
+has a similar goal, to detail how an ideal InnerSource project would
+be, but there are not two organizations using the same InnerSource
+approach.
+
+Thus, metrics useful for some contexts, for example technological
+organizations, might not apply to other context such as banks due to
+external factors such as legal regulations that are even different from
+country to country.
+
+In addition to all of this, when measuring InnerSource, there are three
+main purposes to use metrics: check on going work, lead process
+improvement[^5] and motivational aspects.
+
+-   **Check** on going work: this helps to understand where the
+    development is right now. To be aware of the status helps to
+    understand how fast things are changing when a new process is in the
+    pipeline. This also helps to go from A to B and even trying several
+    approaches to the same problem and have tests for this.
+
+-   **Lead** process improvement: InnerSource means a change in how
+    process works in the following. From a hierarchical way to a flatter
+    way of working, InnerSource needs indicators to help to determine
+    if that process improvement is properly working. And if this is not
+    working, then using another approach or apply other policies.
+
+-   **Motivational** aspects: InnerSource also means cultural change,
+    and this is not usually taken into account in other methodologies.
+    Indeed, this cultural change is identified in InnerSource as key.
+    This should be the type of actions that will help to migrate from a
+    traditional way of working to a more transparent and community-
+    oriented way to work. And metrics can help to lead this process.
+    First, to let developers know where they are and how their process
+    is working, but also to have some fun within the work and
+    competitions through challenges, hackathons and other measurable
+    activities that lead to a more community-oriented organizations.

measuring/metrics/index.md

@@ -0,0 +1,33 @@
+# InnerSource Metrics
+
+This directory contains the metrics used to measure InnerSource success. Each metric is defined using the Goal-Question-Metric (GQM) approach and provides specific ways to measure different aspects of InnerSource adoption and effectiveness.
+
+## Available Metrics
+
+1. [Code Contributions](code-contributions.md)
+   - Measures non-owner commits to a project
+   - Tracks contribution diversity across people, business units, and time
+   - Unit: Ordinal number
+
+2. [Contribution Distance](contribution-distance.md)
+   - Measures organizational distance between owning team and contributing team
+   - Indicates collaboration effectiveness and project impact
+   - Unit: Manager levels
+
+3. [Number of InnerSource Repositories](number-of-innersource-repositories.md)
+   - Tracks adoption of InnerSource practices across repositories
+   - Identifies repositories with InnerSource characteristics
+   - Unit: Number of repositories
+
+4. [Usage Count](usage-count.md)
+   - Measures how many times an InnerSource project is used
+   - Tracks usage patterns across business units and time
+   - Unit: Ordinal number
+
+## Templates
+
+- [GQM Metric Template](gqm_metric_template.md) - Template for creating new metrics using the GQM approach
+
+## Related Resources
+
+- [Back to the overall graph](../use_gqm.md)

measuring/questions/index.md

@@ -0,0 +1,28 @@
+# InnerSource Questions
+
+This directory contains the questions used in the Goal-Question-Metric (GQM) approach to measure InnerSource success. Each question helps evaluate different aspects of InnerSource adoption and effectiveness.
+
+## Available Questions
+
+1. [What is the InnerSource adoption trend?](adoption-trend.md)
+   - Helps evaluate the growth and success of InnerSource programs
+   - Identifies potential program strategy issues or impediments
+   - Related metrics: Number of InnerSource repositories
+
+2. [Who contributes to the InnerSource project?](who-contributes.md)
+   - Examines the diversity and scope of project contributions
+   - Covers various types of contributions (code, documentation, discussion)
+   - Related metrics: Code Contributions, Contribution Distance
+
+3. [Who uses the InnerSource project?](who-uses.md)
+   - Tracks project adoption and usage patterns
+   - Covers different usage types (modules, APIs, UIs)
+   - Related metrics: Usage count
+
+## Templates
+
+- [GQM Question Template](gqm_question_template.md) - Template for creating new questions using the GQM approach
+
+## Related Resources
+
+- [Back to the overall graph](../use_gqm.md)

measuring/use_gqm.md#goals

@@ -10,7 +10,7 @@
   * [Compare canto ten de InnerSource a súa infraestrutura](infrastructure/assessment.md)
   * [Autoría e revisións](infrastructure/authors.md)
 * [Cales, cando e como empregalas](measuring/measuring.md)
-  * [Obxectivos no uso das métricas](measuring/goals.md)
+  * [Obxectivos no uso das métricas](measuring/goals_using_metrics.md)
   * [Áreas de análise](measuring/areas.md)
   * [Enfoque GQM (Obxectivo-Pregunta-Métrica)](measuring/gqm.md)
   * [Estratexia](measuring/strategy.md)