Merge branch 'migrating-from-innersource-to-opensource' of github.com:jeffabailey/InnerSourcePatterns into migrating-from-innersource-to-opensource

Author: jeffabailey

.github/workflows/book.yml

@@ -33,7 +33,7 @@ jobs:
         echo "Generated book for: ${{ matrix.language }}" >> $GITHUB_STEP_SUMMARY
 
     - name: Commit updated toc.md for the book
-      uses: stefanzweifel/git-auto-commit-action@v5
+      uses: stefanzweifel/git-auto-commit-action@v6
       with:
         commit_message: Writing updated toc.md for the ${{ matrix.language }} book
         branch: ${{ github.head_ref }}

.github/workflows/generate-mindmap.yml

@@ -26,10 +26,6 @@ jobs:
       # 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", "./es"]
-
     steps:
     - uses: actions/checkout@v5
     - name: Use Node.js
@@ -40,20 +36,30 @@ jobs:
         cache-dependency-path: pattern-categorization/package-lock.json
     - name: Install Node.js dependencies
       run: npm install
-    - name: Run Markmap
-      run: npx markmap --no-toolbar ${{ matrix.folder }}/innersource-program-mind-map.md -o ${{ matrix.folder }}/innersource-program-mind-map.html
-    - name: Screenshot Markmap Website
-      id: screenshot-generator
-      uses: swinton/[email protected]
-      with:
-        source: pattern-categorization/${{ matrix.folder }}/innersource-program-mind-map.html #strange syntax here. seems to not respect the working-directory default either
-        destination: innersource-program-mind-map.png
-        full-page: false
-    - name: Copy Screenshot
-      run: cp ${{ steps.screenshot-generator.outputs.path }} ${{ matrix.folder }}
-    - name: Reduce Screenshot Size (PNG)
-      run: npx optipng ${{ matrix.folder }}/innersource-program-mind-map.png
+    - name: Disable AppArmor
+      run: |
+        # Disable AppArmor for unprivileged user namespaces (required for 'pageres')
+        sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0  
+    - name: Generate mindmap and take screenshot
+      run: |
+        # Loops over the top-level folder and all immediate sub-folders, except for "node_modules"
+        for dir in . */; do
+          # Skip node_modules
+          [ "$(basename "$dir")" = "node_modules" ] && continue
+          
+          echo "Creating mindmap PNG for: $dir"
+          (
+            # Create markmap HTML 
+            npx markmap --no-open --no-toolbar $dir/innersource-program-mind-map.md -o $dir/innersource-program-mind-map.html
+
+            # Take the screenshot
+            npx pageres $dir/innersource-program-mind-map.html --overwrite --filename=$dir/innersource-program-mind-map 2560x1600
+
+            # Reduce Screenshot Size (PNG)
+            npx optipng -silent $dir/innersource-program-mind-map.png
+          )
+        done
     - name: Commit Changes
-      uses: stefanzweifel/git-auto-commit-action@v5
+      uses: stefanzweifel/git-auto-commit-action@v6
       with:
         commit_message: Re-creating markmap and screenshot

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

@@ -21,7 +21,7 @@ jobs:
 
       - name: Get changed files
         id: changed-files
-        uses: tj-actions/changed-files@v46
+        uses: tj-actions/changed-files@v47
 
       - name: Filter markdown files only
         run: |

.github/workflows/overview-complete.yml

@@ -0,0 +1,46 @@
+# Check if all patterns are listed in README.md
+name: Overview Complete
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  overviewComplete:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Check if all patterns are listed in README.md
+        run: |
+          README="README.md"
+
+          # Ensure README.md exists
+          if [[ ! -f "$README" ]]; then
+              echo "Error: $README not found!"
+              exit 1
+          fi
+
+          missing=0
+
+          for file in patterns/*/*.md; do
+              if grep -qF "$file" "$README"; then
+                  echo "✔ Found: $file"
+              else
+                  echo "✘ Missing: $file"
+                  echo "✘ Pattern file not listed in README.md: $file" >> $GITHUB_STEP_SUMMARY
+                  missing=$((missing + 1))
+              fi
+          done
+
+          if [[ $missing -gt 0 ]]; then
+              echo "Some patterns are missing from $README."
+              exit 1
+          else
+              echo "All patterns are listed in $README."
+              exit 0
+          fi

.github/workflows/pattern-metrics.yaml

@@ -53,7 +53,7 @@ jobs:
         echo "CODEOWNERS_FILTER=$CODEOWNERS_FILTER" >> "$GITHUB_ENV"
 
     - name: Run issue-metrics tool for issues
-      uses: github/issue-metrics@v2
+      uses: github/issue-metrics@v3
       env:
         GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         SEARCH_QUERY: 'repo:InnerSourceCommons/InnerSourcePatterns is:issue created:${{ env.last_month }} -reason:"not planned" ${{ env.CODEOWNERS_FILTER }}'
@@ -66,7 +66,7 @@ jobs:
         mv ./issue_metrics.md ready_to_merge_issues_report.md
 
     - name: Run issue-metrics tool for PRs
-      uses: github/issue-metrics@v2
+      uses: github/issue-metrics@v3
       env:
         GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         SEARCH_QUERY: 'repo:InnerSourceCommons/InnerSourcePatterns is:pr created:${{ env.last_month }} -reason:"not planned" ${{ env.CODEOWNERS_FILTER }}'

.lycheeignore

@@ -13,4 +13,5 @@ https://www.chathamhouse.org/about-us/chatham-house-rule
 https://www.linkedin.com/in
 # 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
-https://dl.acm.org/doi/10.5555/3158161.3158175
+https://dl.acm.org/doi/10.5555/3158161.3158175
+https://retromat.org/en/

README.md

@@ -97,6 +97,8 @@ Our mission
 * [Walk the InnerSource talk](/patterns/1-initial/walk-the-innersource-talk.md) - *Teams across the organization are encouraged to adopt InnerSource principles such as working openly, sharing code, and collaborating transparently. But, if the team behind the InnerSource initiative doesn’t follow these practices themselves, it undermines credibility and adoption. Therefore, this team should lead by example: documenting their decisions as code, working in the open, and treating their work as an InnerSource project to build trust and show others how it’s done.*
 * [Require InnerSource before Open Source](/patterns/1-initial/innersource-before-open-source.md) - *Maintaining and managing open source projects can be challenging for organizations, due to a lack of internal infrastructure and people with the knowledge of the required collaboration practices. By requiring projects to be InnerSource before becoming open source, teams have time to establish the necessary internal support, governance, and collaboration skills needed for successful community engagement.*
 * [AI Code Generation Context](patterns/1-initial/ai-code-generation-context.md) - *AI tools generate code that diverges from project standards and architectural patterns. Provide an AI Code Generation Context within the repositories to guide AI tools in producing contributions that align with existing project conventions, reducing review friction and maintaining code consistency.*
+* [InnerSource as a Career Booster](patterns/1-initial/innersource-as-career-booster.md) - *Many employees wonder how contributing to InnerSource projects benefits their careers beyond their immediate team objectives. By engaging in InnerSource, individuals expand their skills, grow their network, increase visibility across the organization, and unlock new career opportunities.*
+* [Migrating from InnerSource to Open Source](patterns/1-initial/migrating-from-innersource-to-open-source.md) - *TBD*
 
 <!--
 NOTE: The 'Initial' Patterns below don't have a Patlet yet, which is essential for readers to quickly browse our patterns.