Merge branch 'InnerSourceCommons:main' into main

Author: taku333

.github/workflows/contributor-report.yaml

@@ -37,7 +37,7 @@ jobs:
         SPONSOR_INFO: "true"
 
     - name: Create issue
-      uses: peter-evans/create-issue-from-file@v4
+      uses: peter-evans/create-issue-from-file@v5
       with:
         title: "Monthly Metrics: Contributors ${{ env.START_DATE }}..${{ env.END_DATE }}"
         token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/generate-mindmap.yml

@@ -21,6 +21,10 @@ jobs:
   generate-mindmap:
     runs-on: ubuntu-latest
 
+    permissions:
+      # Give the default GITHUB_TOKEN write permission to commit and push the changed files back to the repository.
+      contents: write
+
     strategy:
       matrix:
         folder: [".", "./gl", "./pt-br"]

.github/workflows/link-checker-prs.yml

@@ -21,7 +21,7 @@ jobs:
 
       - name: Get changed files
         id: changed-files
-        uses: tj-actions/changed-files@v44
+        uses: tj-actions/changed-files@v45
 
       - name: Filter markdown files only
         run: |
@@ -37,7 +37,7 @@ jobs:
 
       - if: ${{ env.MARKDOWN_FILES != '' }}
         name: Link Checker
-        uses: lycheeverse/lychee-action@v1.5.2
+        uses: lycheeverse/lychee-action@v2.2.0
         with:
           args: --verbose --no-progress --exclude-mail --cache --max-cache-age 1d $MARKDOWN_FILES
           fail: true

.github/workflows/link-checker.yml

@@ -9,6 +9,7 @@ on:
   schedule:
     # * is a special character in YAML so you have to quote this string
     - cron:  '30 8 * * 5'
+  workflow_dispatch:
 
 jobs:
   linkChecker:
@@ -24,7 +25,7 @@ jobs:
           restore-keys: cache-lychee-
 
       - name: Link Checker
-        uses: lycheeverse/lychee-action@v1.5.2
+        uses: lycheeverse/lychee-action@v2.2.0
         with:
           args: --verbose --no-progress --exclude-mail --cache --max-cache-age 1d README.md patterns/ book/ translation/
           fail: true

.github/workflows/pattern-metrics.yaml

@@ -80,7 +80,7 @@ jobs:
         cat ready_to_merge_issues_report.md hr.md issue_metrics.md > all.md
 
     - name: Create issue
-      uses: peter-evans/create-issue-from-file@v4
+      uses: peter-evans/create-issue-from-file@v5
       with:
         title: "Monthly Metrics: New Issues + New Pull Requests ${{ env.last_month }}"
         token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/vale.yml

@@ -21,7 +21,7 @@ jobs:
     - uses: actions/checkout@v4
 
     - name: Vale Linting
-      uses: errata-ai/vale-action@reviewdog
+      uses: errata-ai/vale-action@v2
       with:
         files: '["patterns/2-structured/", "patterns/3-validated/"]'
         vale_flags: "--glob=*.md"

.lycheeignore

@@ -9,4 +9,7 @@ fearlesschangepatterns.com
 https://ulir.ul.ie/bitstream/handle/10344/4443/Stol_2014_inner.pdf
 .*@andrew.clegg.*
 https://m.dotdev.co/how-to-write-a-readme-that-rocks-bc29f279611a
-https://www.chathamhouse.org/about-us/chatham-house-rule
+https://www.chathamhouse.org/about-us/chatham-house-rule
+
+# from source-code-inventory.md / no longer reachable but we want to keep the link in the pattern in case we find it again.
+https://github.com/trieshard/source-strategy-assessment/blob/master/framework.md

meta/boardreports/2024-11.md

@@ -0,0 +1,64 @@
+# InnerSource Patterns WG - Report for Board Meeting 2024-11
+
+## Meta
+
+* Reporting Period: 2024-08..2024-10
+* [merged PRs](https://github.com/InnerSourceCommons/InnerSourcePatterns/pulls?q=is%3Apr+closed%3A2024-08..2024-10+is%3Amerged)
+* [opened issues](https://github.com/InnerSourceCommons/InnerSourcePatterns/issues?q=is%3Aissue+created%3A2024-08..2024-10+is%3Aopen)
+
+## Engagement
+
+The [patterns book][] is the way InnerSource practices are captured and shared. Recent web analytics:
+
+* total traffic on the patterns book (tracking_id: `G-QL1S8MW5D9`)
+  * 14,308 views total (prev 15,021)
+  * 1,908 users (prev 1,897)
+* Most popular patterns:
+  * 30 Day Warranty
+  * Core Team
+  * Maturity Model
+  * Standard Base Documentation
+  * InnerSource Portal
+* traffic for translations:
+  * Japanese (/v/ja) - 1300 (prev no data in Google Analytics)
+  * Chinese (/v/zh) - 305 (prev 545)
+  * Brazilian Portuguese (/v/pt-br) - 332 (prev 358)
+  * Galician (/v/gl) - 46 (prev 68)
+  * English (/) - roughly 12,300 (14,308 - sum of translation views above)
+* interpretations
+  * Of our translated content, the Japanese patterns are consumed the most (almost 10% of our total views). Great to see that the content provides value to users in that geo/language.
+  * Year over year the total views are down quite a bit. not sure why. (see reports from 2023)
+
+## Changes
+
+Changes are contributed via the [InnerSourcePatterns][] repository:
+
+* new patterns:
+  * none
+* translations
+  * [fixes](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/722) to the Chinese translations / thanks @node
+* additions of Known Instances (applications of our patterns in the wild)
+  * none
+* other
+  * [great review](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/710) / thanks @semioticrobotic
+  * [fixed link to bazaar plugin](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/711) / thanks @khola
+
+## Things to come
+
+* We would like to do one round of cleanup of old PRs/issues that are unlikely to still be implemented as they are stale for too long.
+* (still) Toying with the idea to add [Adopters pages](https://innersourcecommons.gitbook.io/innersource-patterns-staging/v/adopters-test/adopters/adopters) to our book. Goal: showcase the organizations and the patterns they use more prominently in our book. Looking for feedback! More [details here](https://github.com/InnerSourceCommons/InnerSourcePatterns/issues/623).
+* Some PRs are stuck. Reason is mostly that I (@spier) have less time to review things or communication with the contributor stopped somewhere.
+
+## Trusted Committers (Community)
+
+* Last [Trusted Committer][] added was [@yuhattor](https://github.com/yuhattor) (added 2022-07-21)
+* Trusted Committer candidates in the pipeline: No
+* Finding new contributors and further trusted committers continues to be the main challenge of the InnerSource Patterns project
+
+## Next Goals
+
+Same as previous Board report.
+
+[patterns book]: https://patterns.innersourcecommons.org/
+[InnerSourcePatterns]: https://github.com/InnerSourceCommons/InnerSourcePatterns/
+[Trusted Committer]: https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/main/TRUSTED-COMMITTERS.md

pattern-categorization/gl/innersource-program-mind-map.png

@@ -20,7 +20,7 @@
 </head>
 <body>
 <svg id="mindmap"></svg>
-<script src="https://cdn.jsdelivr.net/npm/d3@7.8.5/dist/d3.min.js"></script><script src="https://cdn.jsdelivr.net/npm/markmap-view@0.15.4/dist/browser/index.js"></script><script>((getMarkmap, getOptions, root, jsonOptions) => {
+<script src="https://unpkg.com/d3@7.8.5/dist/d3.min.js"></script><script src="https://unpkg.com/markmap-view@0.15.4/dist/browser/index.js"></script><script>((getMarkmap, getOptions, root, jsonOptions) => {
           const markmap = getMarkmap();
           window.mm = markmap.Markmap.create('svg#mindmap', (getOptions || markmap.deriveOptions)(jsonOptions), root);
         })(() => window.markmap,null,{"type":"heading","depth":0,"payload":{"lines":[0,1]},"content":"<a href=\"https://patterns.innersourcecommons.org/toc\">InnerSource Program</a>","children":[{"type":"heading","depth":1,"payload":{"lines":[2,3]},"content":"Begin","children":[{"type":"heading","depth":2,"payload":{"lines":[4,5]},"content":"Program Setup","children":[{"type":"heading","depth":3,"payload":{"lines":[6,7]},"content":"Management hesitates to invest in InnerSource","children":[{"type":"heading","depth":4,"payload":{"lines":[8,9]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/start-as-experiment\">Start as an Experiment</a>","children":[]}]},{"type":"heading","depth":3,"payload":{"lines":[10,11]},"content":"Slow community growth hinders InnerSource","children":[{"type":"heading","depth":4,"payload":{"lines":[12,13]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/dedicated-community-leader\">Dedicated Community Leader</a>","children":[]}]},{"type":"heading","depth":3,"payload":{"lines":[14,15]},"content":"InnerSource principles are not intuitive for everybody","children":[{"type":"heading","depth":4,"payload":{"lines":[16,17]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/document-your-guiding-principles\">Document your Guiding Principles</a>","children":[]}]}]},{"type":"heading","depth":2,"payload":{"lines":[18,19]},"content":"Project Setup","children":[{"type":"heading","depth":3,"payload":{"lines":[20,21]},"content":"Hard to assess a project quickly","children":[{"type":"heading","depth":4,"payload":{"lines":[22,23]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/base-documentation\">Standard Base Documentation</a>","children":[]}]},{"type":"heading","depth":3,"payload":{"lines":[24,25]},"content":"Ad-hoc communication hinders project growth","children":[{"type":"heading","depth":4,"payload":{"lines":[26,27]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/communication-tooling\">Communication Tooling</a>","children":[]}]},{"type":"heading","depth":3,"payload":{"lines":[28,29]},"content":"Intransparent roadmap and direction of the project","children":[{"type":"heading","depth":4,"payload":{"lines":[30,31]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/issue-tracker\">Issue Tracker Use Cases</a>","children":[]}]}]}]},{"type":"heading","depth":1,"payload":{"lines":[32,33]},"content":"Adopt","children":[{"type":"heading","depth":2,"payload":{"lines":[34,35]},"content":"Valuation Challenges","children":[{"type":"heading","depth":3,"payload":{"lines":[36,37]},"content":"How to measure a project's business value","children":[{"type":"heading","depth":4,"payload":{"lines":[38,39]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/crossteam-project-valuation\">Cross-Team Project Valuation</a>","children":[]}]},{"type":"heading","depth":3,"payload":{"lines":[40,41]},"content":"Can we rely on the project for an extended period?","children":[{"type":"heading","depth":4,"payload":{"lines":[42,43]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/release-process\">Standard Release Process</a>","children":[]},{"type":"heading","depth":4,"payload":{"lines":[44,45]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/base-documentation\">Standard Base Documentation</a>","children":[]}]}]},{"type":"heading","depth":2,"payload":{"lines":[46,47]},"content":"Cultural Challenges","children":[{"type":"heading","depth":3,"payload":{"lines":[48,49]},"content":"Unrecognized effort","children":[{"type":"heading","depth":4,"payload":{"lines":[50,51]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/praise-participants\">Praise Participants</a>","children":[]},{"type":"heading","depth":4,"payload":{"lines":[52,53]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/trusted-committer\">Trusted Committer</a>","children":[]}]}]},{"type":"heading","depth":2,"payload":{"lines":[54,55]},"content":"Technical Challenges","children":[{"type":"heading","depth":3,"payload":{"lines":[56,57]},"content":"Not meeting everyone's needs","children":[{"type":"heading","depth":4,"payload":{"lines":[58,59]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/common-requirements\">Common Requirements</a>","children":[]}]},{"type":"heading","depth":3,"payload":{"lines":[60,61]},"content":"Fear of shared support responsibility","children":[{"type":"heading","depth":4,"payload":{"lines":[62,63]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/service-vs-library\">Service vs. Library</a>","children":[]}]},{"type":"heading","depth":3,"payload":{"lines":[64,65]},"content":"Project is difficult to contribute to and use","children":[{"type":"heading","depth":4,"payload":{"lines":[66,67]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/core-team\">Core Team</a>","children":[]}]}]},{"type":"heading","depth":2,"payload":{"lines":[68,69]},"content":"Organizational Challenges","children":[{"type":"heading","depth":3,"payload":{"lines":[70,71]},"content":"Discouragement of contributing resource","children":[{"type":"heading","depth":4,"payload":{"lines":[72,73]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/contracted-contributor\">Contracted Contributor</a>","children":[]}]},{"type":"heading","depth":3,"payload":{"lines":[74,75]},"content":"Rejection of accepting contribution","children":[{"type":"heading","depth":4,"payload":{"lines":[76,77]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/30-day-warranty\">30 Day Warranty</a>","children":[]}]},{"type":"heading","depth":3,"payload":{"lines":[78,79]},"content":"Radical change of management","children":[{"type":"heading","depth":4,"payload":{"lines":[80,81]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/review-committee\">Review Committee</a>","children":[]}]},{"type":"heading","depth":3,"payload":{"lines":[82,83]},"content":"Fear of shared support responsibility","children":[{"type":"heading","depth":4,"payload":{"lines":[84,85]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/service-vs-library\">Service vs. Library</a>","children":[]}]},{"type":"heading","depth":3,"payload":{"lines":[86,87]},"content":"Not enough maintainers to scale","children":[{"type":"heading","depth":4,"payload":{"lines":[88,89]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/trusted-committer\">Trusted Committer</a>","children":[]}]},{"type":"heading","depth":3,"payload":{"lines":[90,91]},"content":"Difficult cross-team coordination","children":[{"type":"heading","depth":4,"payload":{"lines":[92,93]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/transparent-cross-team-decision-making-using-rfcs\">Transparent Cross-Team Decision Making using RFCs</a>","children":[]}]},{"type":"heading","depth":3,"payload":{"lines":[94,95]},"content":"Project without an owner/maintainer","children":[{"type":"heading","depth":4,"payload":{"lines":[96,97]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/core-team\">Core Team</a>","children":[]},{"type":"heading","depth":4,"payload":{"lines":[98,99]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/group-support\">Group Support</a>","children":[]}]}]},{"type":"heading","depth":2,"payload":{"lines":[100,101]},"content":"Cross Legal Entities Challenges","children":[{"type":"heading","depth":3,"payload":{"lines":[102,103]},"content":"Concern on legal liabilities or cross-company accounting","children":[{"type":"heading","depth":4,"payload":{"lines":[104,105]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/innersource-license\">InnerSource License</a>","children":[]}]}]}]},{"type":"heading","depth":1,"payload":{"lines":[106,107]},"content":"Grow","children":[{"type":"heading","depth":2,"payload":{"lines":[108,109]},"content":"Discovery Challenges","children":[{"type":"heading","depth":3,"payload":{"lines":[110,111]},"content":"Can't find matching projects","children":[{"type":"heading","depth":4,"payload":{"lines":[112,113]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/gig-marketplace\">Gig Marketplace</a>","children":[]},{"type":"heading","depth":4,"payload":{"lines":[114,115]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/innersource-portal\">InnerSource Portal</a>","children":[]}]},{"type":"heading","depth":3,"payload":{"lines":[116,117]},"content":"Difficult to find active projects","children":[{"type":"heading","depth":4,"payload":{"lines":[118,119]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/repository-activity-score\">Repository Activity Score</a>","children":[]}]}]}]},{"type":"heading","depth":1,"payload":{"lines":[120,121]},"content":"Scale","children":[{"type":"heading","depth":2,"payload":{"lines":[122,123]},"content":"Self Education/Improvement Challenges","children":[{"type":"heading","depth":3,"payload":{"lines":[124,125]},"content":"Not aware of InnerSource best practices","children":[{"type":"heading","depth":4,"payload":{"lines":[126,127]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/maturity-model\">Maturity Model</a>","children":[]}]},{"type":"heading","depth":3,"payload":{"lines":[128,129]},"content":"Lack of open source knowledge","children":[{"type":"heading","depth":4,"payload":{"lines":[130,131]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/document-your-guiding-principles\">Document your Guiding Principles</a>","children":[]}]}]},{"type":"heading","depth":2,"payload":{"lines":[132,133]},"content":"Technical Challenges","children":[{"type":"heading","depth":3,"payload":{"lines":[134,135]},"content":"Increasing maintenance overhead","children":[{"type":"heading","depth":4,"payload":{"lines":[136,137]},"content":"<a href=\"https://patterns.innersourcecommons.org/p/extensions-for-sustainable-growth\">Extensions for Sustainable Growth</a>","children":[]}]}]}]}]},null)</script>