-
Notifications
You must be signed in to change notification settings - Fork 202
Added new pattern: Start as Experiment #66
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
start-as-experiment.md
Outdated
by for InnerSource. | ||
- If the InnerSource initiative has a huge uptake among developers and if many | ||
projects come to rely on it, a decision to shut it down will be very | ||
unpopular and therefore hard to make. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
If many projects come to rely on InnerSource, doesn't that mean that it is successful? Would a decision to shut it down then be very unlikely? Does this force represent a fear that management has about even starting this (a worry that they would lose control over the program because of its popularity)?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
If many projects come to rely on InnerSource, doesn't that mean that it is successful?
That would be my definition of success, yes. But then, I'm not a manager. The benefits of InnerSource can sometimes be hard to quantify, especially the soft factors, such as employee satisfaction, improved learning and increased networking. Not being able to put hard numbers on e. g. the increase in efficiency might make InnerSource look like a failure to some managers.
Would a decision to shut it down then be very unlikely?
I think there are shades of grey, here. If the company does not support InnerSource on the highest level anymore (e. g. no funding for central platform), the projects which are relying on InnerSource would most likely maintain a more islolated version of it for their particular use. I guess you could call that InnerSource, too, but it would probably be a step back from the values of openness and transparency.
Does this force represent a fear that management has about even starting this (a worry that they would lose control over the program because of its popularity)?
Yes!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I have added text to explain how managers might fear loss of control due to huge uptake. Not sure how to factor in the rest of your feedback, though, @NewMexicoKid . Any suggestions?
start-as-experiment.md
Outdated
- When implementing new working models such as InnerSource which are radically | ||
different from working models previously practiced in the company, it is | ||
likely that existing, mandatory processes are no longer applicable and even | ||
that one has to operate in a regulatory, sometimes legal no-mans land. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can you elaborate on what some of the regulatory and legal concerns are?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I know of three areas, which were (are) problematic, at least here in Europe:
- Tax problems (a project in one country contributing SW for free, a project in another country makes money of of it)
- Open Source licensing obligations: In my company, there are strict processes ensuring that SW that we publish and that uses OSS complies with the requirements spelled out in their respective licenses. Technically, pushing SW to a platform that is accessible by multiple legal entities is already an act of publishing. I'm guessing that most companies which haven't practiced InnerSource do not have regulations for that in place.
- Export control regulations: There are a lot of export control regulations (most of them put in place by the US) that apply to SW being published (same case as above).
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm confused, though. These concerns wouldn't apply to InnerSource efforts (within a single company), right?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@rrrutledge , I think that the tax concerns would still apply within a single company if that company spanned several countries (each with different tax laws); but I am not a tax expert.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@NewMexicoKid is right. Bosch, e. g., has hundreds (!) of legal entities in more than 100 countries world wide.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Got it.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I've updated the force to reflect your feedback.
|
||
# Forces | ||
|
||
- Managers will want to validate the claims of improved collaboration through |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
From 7/18/17 patterns meeting: Engineering-led inner source often does not scale to the wider organization because engineers lack a marketing skillset and upward/sideways org traversal.
Are we able to weave this interesting comment/observation in anywhere?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is this comment/observation directly related to the thrust and intent of this pattern?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think this is not directly related, @nyeates. This force was geared towards the desire of mgmt. to validate a new idea before they sign off on it. So it's more related to KPIs and measurements than marketing skills.
start-as-experiment.md
Outdated
- In case of success, the data gathered during the experiment will allow | ||
managers to make a longer lasting commitment to InnerSource. | ||
|
||
Participants in the InnerSource experiment are conscious of the fact that, as |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Comment from 7/18/17 patterns meeting: Consider having a "pivot, change, pause" point. Instead of an end-date, you re-evaluate
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sounds good.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I like it, too!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I've added your idea to replace the end point with a pivot/pause/change point, @nyeates .
|
||
# Solution | ||
|
||
Declare the InnerSource initiative as a time limited experiment. Define and |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
from Erin: mention example for concrete criteria for measuring success
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
From what I was able to gather so far, (this was before I engaged with InnerSource at Bosch), the criteria put in place were used to evaluate the health of the InnerSource communities and not to evaluate the benefits of InnerSource. The thinking was that we need to assess first whether or not InnerSource can flourish within the organisation and that introducing "hard" measurements (efficiency KPIs and such) would substantially alter the nature and outcome of the experiment. Here are some of the criteria put in place for our experiment:
- Geographical distribution (of developers)
- Departmental mix (of developers)
- Openness of communication (within community)
- Career path based on merit (within community)
- Democratic decisions (within community)
I have to admit that this is somewhat different from how I wrote it in this pattern. @ErinMB, @NewMexicoKid and @nyeates: should we go about this?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
My opinion: I would rewrite this part of the solution section to better reflect how we approached it at Bosch.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sounds good to me. Would the right thing to do be to reference another pattern. I see two in pull request that may be related (Cross-team Project Valuation, Add pattern for discussion: first steps with metrics). Or create a new one yourself?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I've enhanced the solution and linked to the (not yet existing) patterns as you suggested, @rrrutledge .
start-as-experiment.md
Outdated
- When implementing new working models such as InnerSource which are radically | ||
different from working models previously practiced in the company, it is | ||
likely that existing, mandatory processes are no longer applicable and even | ||
that one has to operate in a regulatory, sometimes legal no-mans land. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@NewMexicoKid is right. Bosch, e. g., has hundreds (!) of legal entities in more than 100 countries world wide.
start-as-experiment.md
Outdated
|
||
# Context | ||
|
||
The majority of software development projects in the company are distributed |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm not sure if the global distribution of developers is relevant context for this pattern. It feels like the following sections would all still apply even without this context.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It's a condition of a (the) known case; I think it doesn't do any harm to mention this point, even if the pattern applies without it. (perhaps there could be a parenthetical statement about how the global distribution is not believed to be a necessary condition for applying this pattern?)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The way I have rewritten this hopefully makes it clear that global distribution is just one example for a criteria.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think that parenthetical statement would be good. Wouldn't want anyone to be discouraged from trying out this pattern because they don't believe it applies to them.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I agree with Russ that the pattern will apply regardless of whether or not SW development is globally distributed or not. I'll remove it. Thanks for persisting, @rrrutledge !
start-as-experiment.md
Outdated
Declare the InnerSource initiative as a time limited experiment. Define and | ||
communicate the criteria for evaluating the experiment and ensure that | ||
sufficient data is gathered to perform the evaluation. Consider establishing | ||
a _Review Committee_ (**tbd**: pattern link) to increase the chances of |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Link to review committee?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done
start-as-experiment.md
Outdated
- If the InnerSource initiative has a huge uptake among developers and if many | ||
projects come to rely on it, a decision to shut it down will be very | ||
unpopular and therefore hard to make. | ||
- When implementing new working models such as InnerSource which are radically |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Split this bullet into 2-3 sentences.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done. It was a very german sentence, indeed ;)
start-as-experiment.md
Outdated
- In case of success, the data gathered during the experiment will allow | ||
managers to make a longer lasting commitment to InnerSource. | ||
|
||
Participants in the InnerSource experiment are conscious of the fact that, as |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I don't understand these last two points in the resulting context - how are they good, desirable, or related to the problem or opening context?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hmm, you have a point there, @rrrutledge . What I wanted to express is that being transparent about the fact that the experiment might not continue would help avoid unnecessary frustration in the developer base. I can say that this wouldn't have helped me personally, though. One way in which the experimental nature of our InnerSource initiative did help was that it communicated to us developers that we had to prove that InnerSource (which we all love) does work well, indeed. Does that resonate with you, @rrrutledge ?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I've rewritten this paragraph. Does this work better for you, @rrrutledge ?
start-as-experiment.md
Outdated
- When implementing new working models such as InnerSource which are radically | ||
different from working models previously practiced in the company, it is | ||
likely that existing, mandatory processes are no longer applicable and even | ||
that one has to operate in a regulatory, sometimes legal no-mans land. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Got it.
|
||
# Forces | ||
|
||
- Managers will want to validate the claims of improved collaboration through |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is this comment/observation directly related to the thrust and intent of this pattern?
|
||
# Solution | ||
|
||
Declare the InnerSource initiative as a time limited experiment. Define and |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sounds good to me. Would the right thing to do be to reference another pattern. I see two in pull request that may be related (Cross-team Project Valuation, Add pattern for discussion: first steps with metrics). Or create a new one yourself?
start-as-experiment.md
Outdated
- In case of success, the data gathered during the experiment will allow | ||
managers to make a longer lasting commitment to InnerSource. | ||
|
||
Participants in the InnerSource experiment are conscious of the fact that, as |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sounds good.
# Title | ||
|
||
Start as an Experiment | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Interested in a Patlet in this pattern?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
absolutely!
@@ -0,0 +1,81 @@ | |||
# Title | |||
|
|||
Start as an Experiment |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think that this pattern may be rediscovering a lot of Trial Run from the Fearless Change Pattens. It's awesome because it means that the content and idea here is solid, but I think it would be good (in the long run) to think about how patterns here relate to what is already documented and printed there.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The connection is obvious, indeed. Are you suggesting to add a section Related Work or something similar?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think that would be good for now. In the long run I'm wondering if we explicitly just start referring people to go read patterns from that book and just focus on any innersource-specific adaptations/examples in our documentation.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Added section on related work.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for these updates.
start-as-experiment.md
Outdated
accompany the experiment with appropriate metrics (**tbd: Pattern link**). If | ||
the projects in the experiment don't provide a direct impact on the companies | ||
revenue, consider introducing [Cross Team | ||
Valuation](crossteam-project-valuation.md) to highlight its value contribution. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for thinking of this document! It is not in master
yet so you'll have to link to the branch for now if you want to reference it.
@@ -0,0 +1,81 @@ | |||
# Title | |||
|
|||
Start as an Experiment |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think that would be good for now. In the long run I'm wondering if we explicitly just start referring people to go read patterns from that book and just focus on any innersource-specific adaptations/examples in our documentation.
start-as-experiment.md
Outdated
- In case of success, the data gathered during the experiment will allow | ||
managers to make a longer lasting commitment to InnerSource. | ||
|
||
Participants in the InnerSource experiment are conscious of the fact that they |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I've rewritten this paragraph. Does this work better for you, @rrrutledge
Yes, this paragraph makes sense to me. Still not able to connect the dots on the one below, though.
Hi patterns community. Here's a new pattern which describes a solution which we have (I think) successfully applied at Bosch. I'm looking forward to your feedback and suggestions.
Cheers,
Georg