Skip to content

Conversation

gruetter
Copy link
Contributor

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

@gruetter gruetter added 1 - Do 1st Review 3-validated Patterns proven in multiple cases with advanced requirements (Please see our contribution handbook) labels Mar 22, 2017
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.
Copy link
Collaborator

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)?

Copy link
Contributor Author

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!

Copy link
Contributor Author

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?

- 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.
Copy link
Collaborator

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?

Copy link
Contributor Author

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).

Copy link
Contributor

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?

Copy link
Collaborator

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.

Copy link
Contributor Author

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.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Got it.

Copy link
Contributor Author

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
Copy link
Contributor

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?

Copy link
Contributor

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?

Copy link
Contributor Author

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.

- 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
Copy link
Contributor

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

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sounds good.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like it, too!

Copy link
Contributor Author

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
Copy link
Contributor Author

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

Copy link
Contributor Author

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?

Copy link
Contributor Author

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.

Copy link
Contributor

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?

Copy link
Contributor Author

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 .

- 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.
Copy link
Contributor Author

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.


# Context

The majority of software development projects in the company are distributed
Copy link
Contributor

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.

Copy link
Collaborator

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?)

Copy link
Contributor Author

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.

Copy link
Contributor

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.

Copy link
Contributor Author

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 !

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
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Link to review committee?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

- 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
Copy link
Contributor

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.

Copy link
Contributor Author

@gruetter gruetter Feb 15, 2018

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 ;)

- 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
Copy link
Contributor

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?

Copy link
Contributor Author

@gruetter gruetter Feb 15, 2018

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 ?

Copy link
Contributor Author

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 ?

- 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.
Copy link
Contributor

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
Copy link
Contributor

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
Copy link
Contributor

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?

- 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
Copy link
Contributor

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

Copy link
Contributor

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?

Copy link
Contributor Author

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
Copy link
Contributor

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.

Copy link
Contributor Author

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?

Copy link
Contributor

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.

Copy link
Contributor Author

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.

Copy link
Contributor

@rrrutledge rrrutledge left a 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.

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.
Copy link
Contributor

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
Copy link
Contributor

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.

- 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
Copy link
Contributor

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.

@gruetter gruetter merged commit 946736e into master Feb 16, 2018
@rrrutledge rrrutledge deleted the pattern/start-as-experiment branch March 18, 2020 13:53
@lenucksi lenucksi added the 📖 Type - Content Work Working on contents is the main focus of this issue / PR label Sep 28, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

3-validated Patterns proven in multiple cases with advanced requirements (Please see our contribution handbook) 📖 Type - Content Work Working on contents is the main focus of this issue / PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants