Skip to content

Commit 7e5e51e

Browse files
committed
[pattern/metrics] Add last comments from the working session
Thanks to @rrrutledge, @NewMexicoKid, @gruetter, Clint, Bob and others for the working session. Modifications were mainly added to the Context and Forces sections. Changes were focused on stating the early stage of the InnerSource initiative to start measuring and having a strategy around metrics.
1 parent a9b511e commit 7e5e51e

File tree

1 file changed

+37
-14
lines changed

1 file changed

+37
-14
lines changed

introducing-metrics-in-innersource.md

Lines changed: 37 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,11 @@
11
# Title
22

3-
Introducing Metrics in the InnerSource Initiative
3+
Introducing Metrics in InnerSource
44

55
# Context
66

7-
An organization is applying InnerSource.
8-
This would like to measure the current status in terms of 'health'
9-
and performance of the initiative, and if the expected outcomes such as
10-
an increase in the level of cross-divisional and cross-location collaboration
11-
are actually taking place.
12-
7+
An organization is planning to apply or this is in the early stages of applying InnerSource. This would like to measure the current status in terms of 'health' and performance of the initiative, and if the expected outcomes such as an increase in the level of cross-divisional and cross-location collaboration are actually taking place.
8+
This pattern applies to early stages of the initiative or are small in their scope, but they may be mature in their initial process and steps.
139

1410

1511
# Problem
@@ -21,6 +17,17 @@ on development activities.
2117
The organization does not really know where to start measuring
2218
things or what are the key parameters to measure.
2319

20+
Changes in the top level initiatives may affect the InnerSource program
21+
as they rely in the good will of some executive from the organization.
22+
23+
You may have a problem justifying the InnerSource effort when there is
24+
a change in business priorities or business leadership. Then you need
25+
something concrete to justify the program. A future problem you're
26+
guarding against.
27+
28+
If there's a change in the C-level, metrics might be helpful to convince
29+
them that InnerSource is useful.
30+
2431

2532
# Forces
2633

@@ -35,15 +42,17 @@ There is not a culture of software development metrics.
3542
Metrics are usually misunderstood if people have not received any
3643
training on those.
3744

38-
Organizations may have unrealistic or premature business
39-
objectives. Even feeling that InnerSource is a
40-
silver bullet for their problems.
41-
42-
Organizations collect vanity metrics that do not track business
43-
objectives' success or failure over time.
45+
Organizations collect vanity of any other type of metrics that do not
46+
track business objectives' sucess or failure over time.
4447

4548
Metrics tend to become goals, will subsequently be gamed and thus meaningless.
4649

50+
Merging existing team metrics if another team has a way to measure how teams are doing; these new measurements could potentially conflict.
51+
52+
Some countries in some organizations may face extra complexity when introducing metrics as they may not allow to track individuals.
53+
54+
Tools and how they use them. There might be a learning curve in the discussion about metrics. And perhaps the tools do not support the metrics we're looking for.
55+
4756
# Solution
4857

4958
Bring developers, middle managers and C-level to have a discussion
@@ -65,6 +74,15 @@ and medium-term goals.
6574
Bring specific discussions on the metrics to be used avoiding per
6675
developer granularity or at least anonymizing that info.
6776

77+
Produce a characterization of metrics as this might be helpful for others
78+
to understand and follow.
79+
80+
* Nearly always InnerSource is not a goal in-and-of itself but a proposal of how to improve some larger problem that the company is having. One class of metrics is around that larger goal (e.g. quality, interrupt-driven work, duplicated code, etc.) and how it is going for the company.
81+
* Another class of metrics is around how much InnerSourcing is happening. A raw definition of InnerSource based on code submission to a repository not owned by the submitter's team could be measurable in a few ways.
82+
* A third class of metrics are KPIs that we believe will improve the raw amount of InnerSourcing happening (e.g. mean-time-to-review, automated test run on PR, etc.).
83+
84+
Note: any proposed metric are just examples and not the ones that should be using. Depending on the selection of business goals to track, those will match with specific set of metrics.
85+
6886

6987
# Resulting Context
7088

@@ -88,10 +106,15 @@ evolves and help them with their daily work.
88106
# Authors
89107

90108
- Daniel Izquierdo
109+
- Tim Yao
110+
- Clint
111+
- Russ Rutledge
112+
- Tom
91113

92114
# Acknowledgement
93115

94-
116+
- Georg
117+
- Bob
95118

96119
# State
97120

0 commit comments

Comments
 (0)