Skip to content

Commit 7b3b16e

Browse files
authored
Various mindmap improvements (#342)
Various changes to the patterns mindmap. - Changed pattern name to "Dedicated Community Leader" - Adding new pattern "Transparent Cross-Team Decision Making using RFCs" - Point pattern links to online book, rather than to markdown files in this repo - Adding new sub-levels to the mindmap for patterns below "Begin". - Adding docs to explain that the mind map in the book needs to be updated too.
1 parent e8ed6b0 commit 7b3b16e

File tree

7 files changed

+50
-23
lines changed

7 files changed

+50
-23
lines changed

book/explore-patterns.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Now how to make it easy for readers to discover the patterns that can help them
66

77
For this purpose we provide this mind map. It **categorizes patterns based on the different phases of an InnerSource Program**, and the challenges that might appear in the respective phases.
88

9-
<img src="./innersource-program-mind-map.png" title="InnerSource Patterns as a Mind Map">
9+
<img src="./innersource-program-mind-map.jpg" title="InnerSource Patterns as a Mind Map">
1010

1111
## Improve this Mind Map
1212

book/innersource-program-mind-map.jpg

291 KB
Loading

book/innersource-program-mind-map.png

-470 KB
Binary file not shown.

book/toc_template.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Instead edit toc_template.md
1414
* [Explore Patterns](../book/explore-patterns.md)
1515
* [Contribute to this book](../book/contribute.md)
1616

17-
<img src="./innersource-program-mind-map.png" title="InnerSource Patterns as a Mind Map">
17+
<img src="./innersource-program-mind-map.jpg" title="InnerSource Patterns as a Mind Map">
1818

1919
## Patterns <a id="p"></a>
2020

pattern-categorization/README.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,13 +8,24 @@ Now how do we make it easier for readers to discover the patterns that can help
88

99
This first categorization effort uses a mind map to categorize patterns based on the different phases of an InnerSource Program, and the challenges that might appear in the respective phases. See [innersource-program-mind-map.html](innersource-program-mind-map.html). Note that this is still an incomplete visualization i.e. it does not contain all of our patterns.
1010

11+
In the mind map you will see patterns categorized from left to right in increasing levels of detail .
12+
13+
The logic for these levels is:
14+
- level 0: the InnerSource program itself (as the root)
15+
- level 1: phase of an InnerSource Program
16+
- level 2: problem category
17+
- level 3: specific problem occurring in an InnerSource context
18+
- level 4: pattern (solution to the problem)
19+
1120
To add new patterns to the mind map, edit the source file `innersource-program-mind-map.md`, and then regenerate the visualization like this:
1221

1322
```
1423
npm install markmap-lib -g
1524
markmap innersource-program-mind-map.md
1625
```
1726

27+
Once this is done please replace `book/innersource-program-mind-map.jpg` with an updated version of this mind map.
28+
1829
## Future Ideas for Categorization
1930

2031
We have some other ideas for categories by which the InnerSource Patterns could be grouped.

pattern-categorization/innersource-program-mind-map.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,6 @@
2626
} = window.markmap;
2727
Markmap.processors = processors;
2828
Markmap.create('svg#mindmap', null, data);
29-
})({"t":"heading","d":1,"v":"<a href=\"https://patterns.innersourcecommons.org/toc\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">InnerSource Program</a>","c":[{"t":"heading","d":2,"v":"Begin","c":[{"t":"heading","d":3,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/start-as-experiment.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Start as an Experiment</a>"},{"t":"heading","d":3,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/dedicated-community-leader.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Dedicated Community Manager</a>"},{"t":"heading","d":3,"v":"Project Setup","c":[{"t":"heading","d":4,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/project-setup/base-documentation.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Standard Base Documentation</a>"},{"t":"heading","d":4,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/project-setup/communication-tooling.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Communication Tooling</a>"},{"t":"heading","d":4,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/project-setup/issue-tracker.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Issue Tracker Use Cases</a>"}]}]},{"t":"heading","d":2,"v":"Adoption","c":[{"t":"heading","d":3,"v":"Valuation Challenges","c":[{"t":"heading","d":4,"v":"How to measure a project's business value","c":[{"t":"heading","d":5,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/crossteam-project-valuation.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Cross-Team Project Valuation</a>"}]}]},{"t":"heading","d":3,"v":"Cultural Challenges","c":[{"t":"heading","d":4,"v":"Unrecognized effort","c":[{"t":"heading","d":5,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/praise-participants.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Praise Participants</a>"},{"t":"heading","d":5,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/trusted-committer.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Trusted Committer</a>"}]}]},{"t":"heading","d":3,"v":"Technical Challenges","c":[{"t":"heading","d":4,"v":"Not meeting everyone's needs","c":[{"t":"heading","d":5,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/common-requirements.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Common Requirements</a>"}]},{"t":"heading","d":4,"v":"Fear of shared support responsibility","c":[{"t":"heading","d":5,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/service-vs-library.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Service vs. Library</a>"}]}]},{"t":"heading","d":3,"v":"Organizational Challenges","c":[{"t":"heading","d":4,"v":"Discouragement of contributing resource","c":[{"t":"heading","d":5,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/contracted-contributor.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Contracted Contributor</a>"}]},{"t":"heading","d":4,"v":"Rejection of accepting contribution","c":[{"t":"heading","d":5,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/30-day-warranty.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">30 Day Warranty</a>"}]},{"t":"heading","d":4,"v":"Radical change of management","c":[{"t":"heading","d":5,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/review-committee.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Review Committee</a>"}]},{"t":"heading","d":4,"v":"Fear of shared support responsibility","c":[{"t":"heading","d":5,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/service-vs-library.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Service vs. Library</a>"}]},{"t":"heading","d":4,"v":"Not enough maintainers to scale","c":[{"t":"heading","d":5,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/trusted-committer.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Trusted Committer</a>"}]}]},{"t":"heading","d":3,"v":"Cross Legal Entities Challenges","c":[{"t":"heading","d":4,"v":"Concern on legal liabilities or cross-company accounting","c":[{"t":"heading","d":5,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/innersource-license.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">InnerSource License</a>"}]}]}]},{"t":"heading","d":2,"v":"Grow","c":[{"t":"heading","d":3,"v":"Discovery Challenges","c":[{"t":"heading","d":4,"v":"Can't find matching projects","c":[{"t":"heading","d":5,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/gig-marketplace.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Gig Marketplace</a>"},{"t":"heading","d":5,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/innersource-portal.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">InnerSource Portal</a>"}]},{"t":"heading","d":4,"v":"Difficult to find active projects","c":[{"t":"heading","d":5,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/repository-activity-score.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Repository Activity Score</a>"}]}]}]},{"t":"heading","d":2,"v":"Scale","c":[{"t":"heading","d":3,"v":"Self Education/Improvement Challenges","c":[{"t":"heading","d":4,"v":"Not aware of InnerSource best practices","c":[{"t":"heading","d":5,"v":"<a href=\"https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/patterns/2-structured/maturity-model.md\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Maturity Model</a>"}]}]}]}]})</script>
29+
})({"t":"heading","d":1,"v":"<a href=\"https://patterns.innersourcecommons.org/toc\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">InnerSource Program</a>","c":[{"t":"heading","d":2,"v":"Begin","c":[{"t":"heading","d":3,"v":"Program Setup","c":[{"t":"heading","d":4,"v":"Management hesitates to invest in InnerSource","c":[{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/start-as-experiment\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Start as an Experiment</a>"}]},{"t":"heading","d":4,"v":"Slow community growth hinders InnerSource","c":[{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/dedicated-community-leader\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Dedicated Community Leader</a>"}]}]},{"t":"heading","d":3,"v":"Project Setup","c":[{"t":"heading","d":4,"v":"Hard to assess a project quickly","c":[{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/base-documentation\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Standard Base Documentation</a>"}]},{"t":"heading","d":4,"v":"Ad-hoc communication hinders project growth","c":[{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/communication-tooling\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Communication Tooling</a>"}]},{"t":"heading","d":4,"v":"Intransparent roadmap and direction of the project","c":[{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/issue-tracker\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Issue Tracker Use Cases</a>"}]}]}]},{"t":"heading","d":2,"v":"Adoption","c":[{"t":"heading","d":3,"v":"Valuation Challenges","c":[{"t":"heading","d":4,"v":"How to measure a project's business value","c":[{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/crossteam-project-valuation\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Cross-Team Project Valuation</a>"}]}]},{"t":"heading","d":3,"v":"Cultural Challenges","c":[{"t":"heading","d":4,"v":"Unrecognized effort","c":[{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/praise-participants\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Praise Participants</a>"},{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/trusted-committer\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Trusted Committer</a>"}]}]},{"t":"heading","d":3,"v":"Technical Challenges","c":[{"t":"heading","d":4,"v":"Not meeting everyone's needs","c":[{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/common-requirements\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Common Requirements</a>"}]},{"t":"heading","d":4,"v":"Fear of shared support responsibility","c":[{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/service-vs-library\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Service vs. Library</a>"}]}]},{"t":"heading","d":3,"v":"Organizational Challenges","c":[{"t":"heading","d":4,"v":"Discouragement of contributing resource","c":[{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/contracted-contributor\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Contracted Contributor</a>"}]},{"t":"heading","d":4,"v":"Rejection of accepting contribution","c":[{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/30-day-warranty\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">30 Day Warranty</a>"}]},{"t":"heading","d":4,"v":"Radical change of management","c":[{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/review-committee\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Review Committee</a>"}]},{"t":"heading","d":4,"v":"Fear of shared support responsibility","c":[{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/service-vs-library\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Service vs. Library</a>"}]},{"t":"heading","d":4,"v":"Not enough maintainers to scale","c":[{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/trusted-committer\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Trusted Committer</a>"}]},{"t":"heading","d":4,"v":"Difficult cross-team coordination","c":[{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/transparent-cross-team-decision-making-using-rfcs\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Transparent Cross-Team Decision Making using RFCs</a>"}]}]},{"t":"heading","d":3,"v":"Cross Legal Entities Challenges","c":[{"t":"heading","d":4,"v":"Concern on legal liabilities or cross-company accounting","c":[{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/innersource-license\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">InnerSource License</a>"}]}]}]},{"t":"heading","d":2,"v":"Grow","c":[{"t":"heading","d":3,"v":"Discovery Challenges","c":[{"t":"heading","d":4,"v":"Can't find matching projects","c":[{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/gig-marketplace\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Gig Marketplace</a>"},{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/innersource-portal\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">InnerSource Portal</a>"}]},{"t":"heading","d":4,"v":"Difficult to find active projects","c":[{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/repository-activity-score\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Repository Activity Score</a>"}]}]}]},{"t":"heading","d":2,"v":"Scale","c":[{"t":"heading","d":3,"v":"Self Education/Improvement Challenges","c":[{"t":"heading","d":4,"v":"Not aware of InnerSource best practices","c":[{"t":"heading","d":5,"v":"<a href=\"https://patterns.innersourcecommons.org/p/maturity-model\" title=\"\" target=\"_blank\" rel=\"noopener noreferrer\">Maturity Model</a>"}]}]}]}]})</script>
3030
</body>
3131
</html>

0 commit comments

Comments
 (0)