diff --git a/.github/workflows/generate-mindmap.yml b/.github/workflows/generate-mindmap.yml
new file mode 100644
index 000000000..accbbd6ee
--- /dev/null
+++ b/.github/workflows/generate-mindmap.yml
@@ -0,0 +1,45 @@
+name: Generate Mindmap
+
+on:
+ push:
+ branches:
+ - "main"
+ pull_request:
+ paths:
+ - ".github/workflows/generate-mindmap.yml"
+ - "pattern-categorization/innersource-program-mind-map.md"
+
+defaults:
+ run:
+ working-directory: pattern-categorization
+
+jobs:
+ generate-mindmap:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v2
+ - name: Use Node.js
+ uses: actions/setup-node@v2
+ with:
+ node-version: 12.x
+ cache: 'npm'
+ cache-dependency-path: pattern-categorization/package-lock.json
+ - name: Install Node.js dependencies
+ run: npm install
+ - name: Run Markmap
+ run: npx markmap --no-toolbar innersource-program-mind-map.md -o innersource-program-mind-map.html
+ - name: Screenshot Markmap Website
+ id: screenshot-generator
+ uses: swinton/screenshot-website@v1.x
+ with:
+ source: pattern-categorization/innersource-program-mind-map.html
+ destination: innersource-program-mind-map.png
+ full-page: false
+ - name: Copy Screenshot
+ run: cp ${{ steps.screenshot-generator.outputs.path }} .
+ - name: Reduce Screenshot Size (PNG)
+ run: npx optipng innersource-program-mind-map.png
+ - name: Commit Changes
+ uses: stefanzweifel/git-auto-commit-action@v4
+ with:
+ commit_message: Re-creating markmap and screenshot
diff --git a/book/README.md b/book/README.md
index 6f6dc76f6..86bb76010 100644
--- a/book/README.md
+++ b/book/README.md
@@ -22,6 +22,7 @@ The `./book` folder contains generator scripts and some extra content required t
- `.github/workflows/book.yml` - A GitHub Action that triggers the execution of `/book/generate_toc.rb`.
- `/book/introduction.md` - The introduction to our book. This content is what the reader sees first when they open the book. The current content is based on [README.md](../README.md). We may need to modify this content even further, to address the readers of the book more specifically, rather than the readers of our GitHub repository.
- `/book/contribute.md` - Information about how to contribute to this book.
+- `/book/explore-patterns.md` - Dedicated page in the book that highlights the mind map of all patterns.
## Objectives of the book
diff --git a/book/explore-patterns.md b/book/explore-patterns.md
index c3670d9e9..1fc8a53ef 100644
--- a/book/explore-patterns.md
+++ b/book/explore-patterns.md
@@ -6,7 +6,7 @@ Now how to make it easy for readers to discover the patterns that can help them
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.
-
+
## Improve this Mind Map
diff --git a/book/innersource-program-mind-map.png b/book/innersource-program-mind-map.png
deleted file mode 100644
index 43a44a022..000000000
Binary files a/book/innersource-program-mind-map.png and /dev/null differ
diff --git a/book/toc_template.md b/book/toc_template.md
index ad26c067d..a00058e11 100644
--- a/book/toc_template.md
+++ b/book/toc_template.md
@@ -14,7 +14,7 @@ Instead edit toc_template.md
* [Explore Patterns](../book/explore-patterns.md)
* [Contribute to this book](../book/contribute.md)
-
+
## Patterns
diff --git a/pattern-categorization/.gitignore b/pattern-categorization/.gitignore
new file mode 100644
index 000000000..c2658d7d1
--- /dev/null
+++ b/pattern-categorization/.gitignore
@@ -0,0 +1 @@
+node_modules/
diff --git a/pattern-categorization/README.md b/pattern-categorization/README.md
index 892108e37..16addaa4c 100644
--- a/pattern-categorization/README.md
+++ b/pattern-categorization/README.md
@@ -6,11 +6,11 @@ Now how do we make it easier for readers to discover the patterns that can help
## InnerSource Program Mind Map
-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.
+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 mind map contains only the patterns that are published in our book (i.e. Level 2-Structured and higher).
In the mind map you will see patterns categorized from left to right in increasing levels of detail.
-The logic for these levels is:
+The logic for these levels is (from left to right):
- level 0: the InnerSource program itself (as the root)
- level 1: phase of an InnerSource Program
@@ -18,22 +18,26 @@ The logic for these levels is:
- level 3: specific problem occurring in an InnerSource context
- level 4: pattern (solution to the problem)
-To add new patterns to the mind map, edit the source file `innersource-program-mind-map.md`, and then regenerate the visualization like this:
+## Adding a Pattern to the Mind Map
+
+To add new patterns to the mind map, edit the file [innersource-program-mind-map.md](innersource-program-mind-map.md). Also see the explanation of the different levels in the mind map above.
+
+Then create a PR with your changes. This triggers an [action](https://github.com/InnerSourceCommons/InnerSourcePatterns/actions/workflows/generate-mindmap.yml) that generates the mind map in HTML and PNG format, and adds those to your PR.
+
+To test your changes locally, you can also generate the mind map yourself like this:
```
-npm install markmap-lib -g
+npm install -g markmap-cli
markmap innersource-program-mind-map.md
```
-Once this is done please replace `book/innersource-program-mind-map.jpg` with an updated version of this mind map.
-
## Future Ideas for Categorization
We have some other ideas for categories by which the InnerSource Patterns could be grouped.
-One is **management and empowerment**. Some patterns help to manage, govern, mitigate risk. Some other patterns help to empower, attract, build communities. This categorization can help others to quickly find the group of patterns that fit their needs.
-
-Another angle is **single project vs organization**. Some patterns are applicable to single project, while others are organizational effort. For people working on specific initiative, single project level patterns might be more interesting. For people working on scaling InnerSource, organizational patterns are important.
+* **Single Project vs Organization** - Some patterns are applicable to single project, while others are organizational effort. For people working on specific initiative, single project level patterns might be more interesting. For people working on scaling InnerSource, organizational patterns are important.
+* **InnerSource Adoption Obstacles** - The [2020 State of InnerSource Research](https://innersourcecommons.org/documents/surveys/State.of.InnerSource.Report.2020.pdf) identifies various obstacles for InnerSource adoption (see page 25). We could identify the patterns that help address each of these obstacles.
+* **Management and Empowerment** - Some patterns help to manage, govern, mitigate risk. Some other patterns help to empower, attract, build communities. This categorization can help others to quickly find the group of patterns that fit their needs.
## References
diff --git a/pattern-categorization/innersource-program-mind-map.html b/pattern-categorization/innersource-program-mind-map.html
index 22d381919..413df2fdd 100644
--- a/pattern-categorization/innersource-program-mind-map.html
+++ b/pattern-categorization/innersource-program-mind-map.html
@@ -20,12 +20,11 @@
-
+ } = getMarkmap();
+ window.mm = Markmap.create('svg#mindmap', getOptions == null ? void 0 : getOptions(), data);
+ })(() => window.markmap,null,{"t":"heading","d":1,"p":{"lines":[0,1]},"v":"InnerSource Program","c":[{"t":"heading","d":2,"p":{"lines":[2,3]},"v":"Begin","c":[{"t":"heading","d":3,"p":{"lines":[4,5]},"v":"Program Setup","c":[{"t":"heading","d":4,"p":{"lines":[6,7]},"v":"Management hesitates to invest in InnerSource","c":[{"t":"heading","d":5,"p":{"lines":[8,9]},"v":"Start as an Experiment"}]},{"t":"heading","d":4,"p":{"lines":[10,11]},"v":"Slow community growth hinders InnerSource","c":[{"t":"heading","d":5,"p":{"lines":[12,13]},"v":"Dedicated Community Leader"}]}]},{"t":"heading","d":3,"p":{"lines":[14,15]},"v":"Project Setup","c":[{"t":"heading","d":4,"p":{"lines":[16,17]},"v":"Hard to assess a project quickly","c":[{"t":"heading","d":5,"p":{"lines":[18,19]},"v":"Standard Base Documentation"}]},{"t":"heading","d":4,"p":{"lines":[20,21]},"v":"Ad-hoc communication hinders project growth","c":[{"t":"heading","d":5,"p":{"lines":[22,23]},"v":"Communication Tooling"}]},{"t":"heading","d":4,"p":{"lines":[24,25]},"v":"Intransparent roadmap and direction of the project","c":[{"t":"heading","d":5,"p":{"lines":[26,27]},"v":"Issue Tracker Use Cases"}]}]}]},{"t":"heading","d":2,"p":{"lines":[28,29]},"v":"Adoption","c":[{"t":"heading","d":3,"p":{"lines":[30,31]},"v":"Valuation Challenges","c":[{"t":"heading","d":4,"p":{"lines":[32,33]},"v":"How to measure a project's business value","c":[{"t":"heading","d":5,"p":{"lines":[34,35]},"v":"Cross-Team Project Valuation"}]}]},{"t":"heading","d":3,"p":{"lines":[36,37]},"v":"Cultural Challenges","c":[{"t":"heading","d":4,"p":{"lines":[38,39]},"v":"Unrecognized effort","c":[{"t":"heading","d":5,"p":{"lines":[40,41]},"v":"Praise Participants"},{"t":"heading","d":5,"p":{"lines":[42,43]},"v":"Trusted Committer"}]}]},{"t":"heading","d":3,"p":{"lines":[44,45]},"v":"Technical Challenges","c":[{"t":"heading","d":4,"p":{"lines":[46,47]},"v":"Not meeting everyone's needs","c":[{"t":"heading","d":5,"p":{"lines":[48,49]},"v":"Common Requirements"}]},{"t":"heading","d":4,"p":{"lines":[50,51]},"v":"Fear of shared support responsibility","c":[{"t":"heading","d":5,"p":{"lines":[52,53]},"v":"Service vs. Library"}]}]},{"t":"heading","d":3,"p":{"lines":[54,55]},"v":"Organizational Challenges","c":[{"t":"heading","d":4,"p":{"lines":[56,57]},"v":"Discouragement of contributing resource","c":[{"t":"heading","d":5,"p":{"lines":[58,59]},"v":"Contracted Contributor"}]},{"t":"heading","d":4,"p":{"lines":[60,61]},"v":"Rejection of accepting contribution","c":[{"t":"heading","d":5,"p":{"lines":[62,63]},"v":"30 Day Warranty"}]},{"t":"heading","d":4,"p":{"lines":[64,65]},"v":"Radical change of management","c":[{"t":"heading","d":5,"p":{"lines":[66,67]},"v":"Review Committee"}]},{"t":"heading","d":4,"p":{"lines":[68,69]},"v":"Fear of shared support responsibility","c":[{"t":"heading","d":5,"p":{"lines":[70,71]},"v":"Service vs. Library"}]},{"t":"heading","d":4,"p":{"lines":[72,73]},"v":"Not enough maintainers to scale","c":[{"t":"heading","d":5,"p":{"lines":[74,75]},"v":"Trusted Committer"}]},{"t":"heading","d":4,"p":{"lines":[76,77]},"v":"Difficult cross-team coordination","c":[{"t":"heading","d":5,"p":{"lines":[78,79]},"v":"Transparent Cross-Team Decision Making using RFCs"}]}]},{"t":"heading","d":3,"p":{"lines":[80,81]},"v":"Cross Legal Entities Challenges","c":[{"t":"heading","d":4,"p":{"lines":[82,83]},"v":"Concern on legal liabilities or cross-company accounting","c":[{"t":"heading","d":5,"p":{"lines":[84,85]},"v":"InnerSource License"}]}]}]},{"t":"heading","d":2,"p":{"lines":[86,87]},"v":"Grow","c":[{"t":"heading","d":3,"p":{"lines":[88,89]},"v":"Discovery Challenges","c":[{"t":"heading","d":4,"p":{"lines":[90,91]},"v":"Can't find matching projects","c":[{"t":"heading","d":5,"p":{"lines":[92,93]},"v":"Gig Marketplace"},{"t":"heading","d":5,"p":{"lines":[94,95]},"v":"InnerSource Portal"}]},{"t":"heading","d":4,"p":{"lines":[96,97]},"v":"Difficult to find active projects","c":[{"t":"heading","d":5,"p":{"lines":[98,99]},"v":"Repository Activity Score"}]}]}]},{"t":"heading","d":2,"p":{"lines":[100,101]},"v":"Scale","c":[{"t":"heading","d":3,"p":{"lines":[102,103]},"v":"Self Education/Improvement Challenges","c":[{"t":"heading","d":4,"p":{"lines":[104,105]},"v":"Not aware of InnerSource best practices","c":[{"t":"heading","d":5,"p":{"lines":[106,107]},"v":"Maturity Model"}]}]}]}]})
+
## Improve this Mind Map
diff --git a/book/innersource-program-mind-map.png b/book/innersource-program-mind-map.png
deleted file mode 100644
index 43a44a022..000000000
Binary files a/book/innersource-program-mind-map.png and /dev/null differ
diff --git a/book/toc_template.md b/book/toc_template.md
index ad26c067d..a00058e11 100644
--- a/book/toc_template.md
+++ b/book/toc_template.md
@@ -14,7 +14,7 @@ Instead edit toc_template.md
* [Explore Patterns](../book/explore-patterns.md)
* [Contribute to this book](../book/contribute.md)
-