> For the complete documentation index, see [llms.txt](https://innersourcecommons.gitbook.io/managing-innersource-projects/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://innersourcecommons.gitbook.io/managing-innersource-projects/measuring/gqm_example.md).

# GQM Use Cases and User Journeys

### How Do I Add New Goals, Questions, and Metrics?

Each goal, question, and metric is defined in its own markdown file. The goals, questions, and metrics are used to:

1. Define clear objectives for InnerSource initiatives
2. Guide the selection of relevant questions
3. Help determine appropriate metrics for measurement

### Adding New Goals, Questions, and Metrics

To add a new goal, question, or metric:

1. Create a new markdown file in the `goals`, `questions`, or `metrics` directory
2. Update the GQM diagram by running the generator in the /scripts/gqm\_gen directory

## How Should I Format Goals Questions & Metrics?

* [gqm\_goal\_template.md](/managing-innersource-projects/measuring/index/use_gqm/index/gqm_goal_template.md)
* [gqm\_question\_template.md](/managing-innersource-projects/measuring/index/use_gqm/index-1/gqm_question_template.md)
* [gqm\_metric\_template.md](/managing-innersource-projects/measuring/index/use_gqm/index-2/gqm_metric_template.md)

## How Do I Add A Goal Question Metric (GQM)?

See the ["Metrics" section of CONTRIBUTING.md](/managing-innersource-projects/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).

### Stakeholder Use Cases

The GQM example serves specific stakeholders.

* **Executives** use them to track the value of an InnerSource program.
* **InnerSource Program Office** uses them to improve the program.
* **InnerSource Project Drivers** use them to advocate for and run their project.

### User Journeys

We use stakeholder user journeys to guide our GQM development.

*Here are a few user journeys:*

**User Journey: Measuring InnerSource Program Success with GQM as an *****Executive***

**Step 1: Awareness and Introduction**

1. **User**: Executive
2. **Goal**: Understand the concept of an InnerSource Program Office and its significance.
3. **Actions:**
   * Receives communication or attends a presentation introducing the concept of InnerSource and its potential benefits.
   * Learn how an InnerSource Program Office can facilitate collaboration, innovation, and knowledge sharing across teams.

**Step 2: Understanding Goals and Objectives**

1. **User**: Executive
2. **Goal**: Grasp the goals and objectives of the InnerSource Program Office.
3. **Actions:**
   * Engages with documentation, presentations, or discussions that detail the goals of the InnerSource Program Office.
   * Learn how the program aims to foster a culture of open collaboration, reduce silos, and accelerate development through shared resources.

**Step 3: Exploring GQM Framework**

1. **User**: Executive
2. **Goal**: Gain familiarity with the Goal-Question-Metric (GQM) framework and its application in measuring InnerSource program success.
3. **Actions:**
   * Reads educational materials or attends a workshop on the GQM framework and its relevance in software development.
   * Understands how GQM helps define measurable objectives that align with the InnerSource Program Office's goals.

**Step 4: Defining Metrics for InnerSource Success**

1. **User**: Executive
2. **Goal**: Learn how to use GQM to define specific metrics for measuring the success of the InnerSource Program Office.
3. **Actions:**
   * Engages with resources that explain how to translate high-level InnerSource goals into measurable metrics using the GQM approach.
   * Collaborates with relevant teams to identify key performance indicators (KPIs) that reflect the success of InnerSource adoption.

**Step 5: Identifying Key Questions**

1. **User**: Executive
2. **Goal**: Understand the importance of formulating specific questions to guide metric measurement.
3. **Actions:**
   * Learn about the significance of crafting well-defined questions directly aligning with the InnerSource Program Office's objectives.
   * Collaborates with program managers to create a set of questions that will help assess the achievement of desired outcomes.

**Step 6: Implementing Metrics and Gathering Data**

1. **User**: Executive
2. **Goal**: Comprehend the process of implementing defined metrics and collecting relevant data.
3. **Actions:**
   * Participates in discussions about the practical implementation of chosen metrics across different teams and projects.
   * Understands the mechanisms for tracking and collecting data to evaluate progress and outcomes.

**Step 7: Analyzing and Interpreting Data**

1. **User**: Executive
2. **Goal**: Gain insights into interpreting metric data and deriving actionable insights.
3. **Actions:**
   * Reviews reports and visualizations that showcase the data collected from various metrics.
   * Collaborates with data analysts and program managers to understand trends, identify successes, and pinpoint areas for improvement.

**Step 8: Driving Continuous Improvement**

1. **User**: Executive
2. **Goal**: Use the metric insights to drive continuous improvement of the InnerSource Program Office.
3. **Actions:**
   * Participates in strategy sessions where metric insights guide decisions and adjustments to the InnerSource program's approach.
   * Collaborates with program managers to iterate on goals, questions, and metrics to ensure they remain aligned with organizational objectives.

**Step 9: Celebrating Success and Adapting**

1. **User**: Executive
2. **Goal**: Recognize and celebrate achievements while remaining adaptable to changing circumstances.
3. **Actions:**
   * Acknowledges and celebrates milestones reached due to InnerSource adoption and program success.
   * Remains open to adapting goals, questions, and metrics based on evolving organizational needs and the dynamic nature of software development.

**Step 10: Ongoing Engagement and Leadership**

1. **User**: Executive
2. **Goal**: Maintain an ongoing commitment to InnerSource's success and leadership.
3. **Actions:**
   * Continues engaging with program managers, teams, and stakeholders to uphold InnerSource principles.
   * Provides leadership and support to foster a culture of collaboration and innovation through InnerSource practices.

**User Journey: Measuring InnerSource Program Success with GQM as an *****InnerSource Program Office***

**Step 1: Introduction to GQM Framework**

1. **User**: InnerSource Program Office
2. **Goal**: Familiarize themselves with the Goal-Question-Metric (GQM) framework and its application for measuring program success.
3. **Actions:**
   * Engages in learning materials, workshops, or training sessions that provide an overview of GQM and its relevance in software development contexts.
   * Understands how GQM assists in aligning goals with specific metrics to evaluate the effectiveness of the InnerSource Program.

**Step 2: Defining InnerSource Program Goals**

1. **User**: InnerSource Program Office
2. **Goal**: Identify and articulate the overarching goals of the InnerSource Program.
3. **Actions:**
   * Engages in discussions with key stakeholders to capture and formalize the strategic objectives of the InnerSource Program.
   * Translates high-level goals into measurable outcomes that can be used to formulate questions and metrics.

**Step 3: Crafting Specific Questions**

1. **User**: InnerSource Program Office
2. **Goal**: Develop precise and actionable questions that align with the InnerSource Program's objectives.
3. **Actions:**
   * Collaborates with stakeholders to formulate questions that address specific aspects of program success, such as collaboration, knowledge sharing, and innovation.
   * Ensures that each question can be answered quantitatively, facilitating effective metric measurement.

**Step 4: Mapping Metrics to Questions**

1. **User**: InnerSource Program Office
2. **Goal**: Identify appropriate metrics that provide insights into the answers to the formulated questions.
3. **Actions:**
   * Explores various metrics that can be collected and analyzed to gauge progress toward the desired outcomes.
   * Matches each metric to the corresponding question to create a clear link between measurement and program goals.

**Step 5: Implementing Data Collection**

1. **User**: InnerSource Program Office
2. **Goal**: Establish mechanisms for collecting relevant data aligned with the identified metrics.
3. **Actions:**
   * Collaborates with teams and departments to set up data collection processes that capture the necessary information for each metric.
   * Ensures data accuracy, consistency, and timeliness for accurate measurement and analysis.

**Step 6: Monitoring and Analyzing Metrics**

1. **User**: InnerSource Program Office
2. **Goal**: Regularly monitor and analyze collected metric data to assess program success.
3. **Actions:**
   * Reviews and analyzes metric data consistently, looking for trends, anomalies, and patterns.
   * Collaborates with data analysts to derive actionable insights and identify areas where the program excels or requires improvement.

**Step 7: Adjusting Program Strategy**

1. **User**: InnerSource Program Office
2. **Goal**: Use metric insights to adapt and refine the InnerSource Program strategy.
3. **Actions:**
   * Engages in strategic discussions to interpret metric insights and make informed decisions for optimizing program outcomes.
   * Collaborates with stakeholders to adjust goals, questions, and metrics based on evolving needs and changing circumstances.

**Step 8: Continuous Improvement and Innovation**

1. **User**: InnerSource Program Office
2. **Goal**: Drive ongoing improvement and innovation through the insights gained from metrics.
3. **Actions:**
   * Uses metric data to identify opportunities for process enhancements, collaboration improvements, and knowledge-sharing innovations.
   * Encourages teams to experiment with new approaches and adapt based on metric-driven feedback.

**Step 9: Communication and Reporting**

1. **User**: InnerSource Program Office
2. **Goal**: Communicate program success, insights, and improvements to stakeholders and leadership.
3. **Actions:**
   * Prepares regular reports and presentations that highlight metric-driven progress and accomplishments.
   * Ensures stakeholders are informed about how the program positively impacts collaboration, innovation, and development outcomes.

**Step 10: Scaling and Sustaining Success**

1. **User**: InnerSource Program Office
2. **Goal**: Scale the successful practices and sustain the positive impact of the InnerSource Program.
3. **Actions:**
   * Shares best practices and insights with other teams and departments, promoting the adoption of successful InnerSource principles.
   * Continues to apply the GQM framework to measure ongoing success, adapt to changes, and foster a culture of collaboration and innovation.

**User Journey: Measuring InnerSource Program Success with GQM as an *****InnerSource Project Driver***

**Step 1: Introduction to GQM Framework**

1. **User**: InnerSource Project Driver
2. **Goal**: Acquire a foundational understanding of the Goal-Question-Metric (GQM) framework and its applicability to measuring InnerSource Program Office success.
3. **Actions:**
   * Engages with educational materials, workshops, or resources that introduce the concepts and principles of GQM in a software development context.
   * Recognizes the significance of aligning specific goals with relevant metrics to gauge program effectiveness.

**Step 2: Understanding InnerSource Program Office Role**

1. **User**: InnerSource Project Driver
2. **Goal**: Comprehend the role and significance of the InnerSource Program Office within the organization.
3. **Actions:**
   * Engages in discussions, presentations, or documentation that outline the responsibilities and objectives of the InnerSource Program Office.
   * Gains insights into how the success of the program office impacts collaboration, knowledge sharing, and innovation across projects.

**Step 3: Defining High-Level Objectives**

1. **User**: InnerSource Project Driver
2. **Goal**: Identify and define overarching objectives for measuring the success of the InnerSource Program Office.
3. **Actions:**
   * Collaborates with program managers and stakeholders to articulate the broad goals and outcomes the program office aims to achieve.
   * Ensures these objectives are clear, measurable, and aligned with the organization's strategic direction.

**Step 4: Formulating Targeted Questions**

1. **User**: InnerSource Project Driver
2. **Goal**: Develop precise and relevant questions that align with the identified program office objectives.
3. **Actions:**
   * Engages in discussions to translate high-level objectives into specific, actionable questions that address various aspects of program success.
   * Ensures that each question is formulated to allow for quantitative measurement and assessment.

**Step 5: Selecting Appropriate Metrics**

1. **User**: InnerSource Project Driver
2. **Goal**: Choose metrics that provide meaningful insights into the answers to the formulated questions.
3. **Actions:**
   * Explores available metrics and key performance indicators (KPIs) that align with the defined questions and objectives.
   * Collaborates with relevant teams and stakeholders to select the most pertinent and practical metrics for measurement.

**Step 6: Implementing Metric Tracking**

1. **User**: InnerSource Project Driver
2. **Goal**: Set up mechanisms for consistently collecting and tracking metric data.
3. **Actions:**
   * Collaborates with data analysts and technical teams to establish automated data collection processes that align with selected metrics.
   * Ensures that data is accurately collected, stored, and maintained for analysis.

**Step 7: Analyzing and Interpreting Insights**

1. **User**: InnerSource Project Driver
2. **Goal**: Analyze the collected metric data to derive actionable insights and evaluate program office success.
3. **Actions:**
   * Reviews metric reports and visualizations, working closely with data analysts to interpret trends and anomalies.
   * Gains a deeper understanding of the impact of the program office on collaboration, innovation, and project outcomes.

**Step 8: Collaborating for Improvement**

1. **User**: InnerSource Project Driver
2. **Goal**: Collaborate with program stakeholders to leverage metric insights for continuous improvement.
3. **Actions:**
   * Engages in cross-functional discussions to discuss insights and their implications for program office strategies.
   * Works with program managers and teams to identify opportunities for enhancing collaboration and driving innovation.

**Step 9: Communicating Success and Learnings**

1. **User**: InnerSource Project Driver
2. **Goal**: Communicate metric-driven successes and lessons learned to stakeholders and the broader organization.
3. **Actions:**
   * Prepares presentations and reports that highlight metric-driven achievements of the InnerSource Program Office.
   * Shares insights on how the program office's efforts have positively influenced collaboration, knowledge sharing, and project outcomes.

**Step 10: Fostering a Culture of Excellence**

1. **User**: InnerSource Project Driver
2. **Goal**: Contribute to fostering a culture of excellence, continuous improvement, and innovation within the InnerSource initiative.
3. **Actions:**
   * Continues collaborating with program managers, teams, and stakeholders to iterate on goals, questions, and metrics.
   * Advocates for the importance of data-driven decision-making and the ongoing role of metrics in program office success.