From 78a6381b5626ff60d54239cf072339337519a46f Mon Sep 17 00:00:00 2001 From: Jeff Bailey <776901+jeffabailey@users.noreply.github.com> Date: Thu, 17 Oct 2024 18:51:36 -0700 Subject: [PATCH 1/6] feat: add markmap partial feat: add markmap shortcode feat: add markmap friendly markmap content fix: skip yourmax processing if no items defined --- content/en/learn/scaling/markmap_content.md | 60 +++++++++++++++++++++ content/en/learn/scaling/mindmap.md | 9 ++++ layouts/partials/markmap.html | 5 ++ layouts/shortcodes/markmap.html | 19 +++++++ static/plugins/youmax/youmax.js | 5 +- 5 files changed, 97 insertions(+), 1 deletion(-) create mode 100644 content/en/learn/scaling/markmap_content.md create mode 100644 content/en/learn/scaling/mindmap.md create mode 100644 layouts/partials/markmap.html create mode 100644 layouts/shortcodes/markmap.html diff --git a/content/en/learn/scaling/markmap_content.md b/content/en/learn/scaling/markmap_content.md new file mode 100644 index 0000000000..90d1d8d6e8 --- /dev/null +++ b/content/en/learn/scaling/markmap_content.md @@ -0,0 +1,60 @@ +# Scaling InnerSource + +## Governance of InnerSource Programs +- Unlock policy constraints +- SDMOs for InnerSource projects +- Accelerated contributions +- Systems +- Roadmap +- Open source principles to fund open source variants of InnerSource +- Technology budget available to support InnerSource +- Repeatable SLAs +- Software/system upgrades + +## [Metrics](https://innersourcecommons.gitbook.io/managing-innersource-projects/measuring) +- Monitoring scale +- Usage +- SLAs +- Readiness +- Contributions +- Accelerated time to market +- Dev time saved +- Developer satisfaction/happiness +- Learning & development / People strategy + +## Research +- Career/involvement boost +- Home trap contributions +- Showcase success stories +- Leader/team gamification +- Money +- Better team/company efficiency +- Physical/digital artifacts + +## Project Governance +- Open source readiness +- Treasurers to manage project success +- Integration of related resources into agile, developer curricula +- Project discovery/governance +- Project maturity +- Stakeholder comms (Education on how to InnerSource) +- Reduce arbitrary uniqueness +- Project alignment +- Project value (product association) + +## Value +- Gaining knowledge +- Reducing time to market / cost of development +- Improve developer/employee experience +- Enhance communications +- Learning & development / People strategy +- Accelerate +- Reduce duplication + +## Awareness & Education +- Engage internal project community +- Showcase projects +- Engage internal experts +- Leadership as what a InnerSource project is +- Projects for Internal Enterprise search +- Advisory board for InnerSource \ No newline at end of file diff --git a/content/en/learn/scaling/mindmap.md b/content/en/learn/scaling/mindmap.md new file mode 100644 index 0000000000..00400db604 --- /dev/null +++ b/content/en/learn/scaling/mindmap.md @@ -0,0 +1,9 @@ +--- +title: "Scaling InnerSource" +subtitle: "How can I scale InnerSource?" +type: "community" +image: "images/learn/patterns.png" +weight: 1 +--- + +{{< markmap path="markmap_content.md" >}} diff --git a/layouts/partials/markmap.html b/layouts/partials/markmap.html new file mode 100644 index 0000000000..35ee4856cc --- /dev/null +++ b/layouts/partials/markmap.html @@ -0,0 +1,5 @@ +{{ if not (.Page.Scratch.Get "markmap") }} + + +{{ .Page.Scratch.Set "markmap" true }} +{{ end }} diff --git a/layouts/shortcodes/markmap.html b/layouts/shortcodes/markmap.html new file mode 100644 index 0000000000..05cd78f250 --- /dev/null +++ b/layouts/shortcodes/markmap.html @@ -0,0 +1,19 @@ +{{ partial "markmap.html" . }} + +{{ $relativePath := .Get "path" }} +{{ $currentDir := .Page.File.Dir }} +{{ $filePath := printf "%s/%s" $currentDir $relativePath }} +{{ $fileContent := readFile $filePath }} + + + +
+ +
diff --git a/static/plugins/youmax/youmax.js b/static/plugins/youmax/youmax.js index 8f1f3d724b..3c28792b72 100644 --- a/static/plugins/youmax/youmax.js +++ b/static/plugins/youmax/youmax.js @@ -176,7 +176,10 @@ var youmax_global_options = {}; showInfo = function(response) { // console.log('showInfo'); // console.log(response); - + if (!response.items) { + return; + } + var channelData = response.items[0]; var channelId = channelData.id; var channelName = channelData.snippet.title; From a59c4b3b07a94aab2201e864e1634cdd0a23b70f Mon Sep 17 00:00:00 2001 From: Jeff Bailey <776901+jeffabailey@users.noreply.github.com> Date: Fri, 18 Oct 2024 08:05:39 -0700 Subject: [PATCH 2/6] chore: add a solid border around the map --- content/en/learn/scaling/markmap_content.md | 7 ++++++- layouts/shortcodes/markmap.html | 1 + 2 files changed, 7 insertions(+), 1 deletion(-) diff --git a/content/en/learn/scaling/markmap_content.md b/content/en/learn/scaling/markmap_content.md index 90d1d8d6e8..2dfaf40c2a 100644 --- a/content/en/learn/scaling/markmap_content.md +++ b/content/en/learn/scaling/markmap_content.md @@ -1,3 +1,8 @@ +--- +markmap: + colorFreezeLevel: 2 +--- + # Scaling InnerSource ## Governance of InnerSource Programs @@ -57,4 +62,4 @@ - Engage internal experts - Leadership as what a InnerSource project is - Projects for Internal Enterprise search -- Advisory board for InnerSource \ No newline at end of file +- Advisory board for InnerSource diff --git a/layouts/shortcodes/markmap.html b/layouts/shortcodes/markmap.html index 05cd78f250..301568d370 100644 --- a/layouts/shortcodes/markmap.html +++ b/layouts/shortcodes/markmap.html @@ -9,6 +9,7 @@ .markmap > svg { width: 100%; height: 1000px; + border: 1px solid; } From 00c21501ba5ac54d095d4e9ce18f650b80460d30 Mon Sep 17 00:00:00 2001 From: Guilherme Dellagustin Date: Fri, 18 Oct 2024 17:39:57 +0200 Subject: [PATCH 3/6] fix: Scaling content on Learn page This commit fixes an issue on the `/learn` page introduced with the mindmap for scaling. Acording to my tests: 1. If a folder does not have a `_index.md` file, every file under the folder will generate a section under the `/learn` page. in This way, both files, `mindmap.md` and `markmap_content.md` were generating content. To fix this, I renamed `mindmap.md` to `_index.md`. 2. When a file does not mave a `description` property in the frontmatter block, it will use the content of the file as description. To fix this I added a `description` property to `mindmap.md` (now renamed to `_index.md`. Related issues - https://github.com/InnerSourceCommons/innersourcecommons.org/pull/902#issuecomment-2422746281 --- content/en/learn/scaling/{mindmap.md => _index.md} | 1 + 1 file changed, 1 insertion(+) rename content/en/learn/scaling/{mindmap.md => _index.md} (61%) diff --git a/content/en/learn/scaling/mindmap.md b/content/en/learn/scaling/_index.md similarity index 61% rename from content/en/learn/scaling/mindmap.md rename to content/en/learn/scaling/_index.md index 00400db604..93c15683ee 100644 --- a/content/en/learn/scaling/mindmap.md +++ b/content/en/learn/scaling/_index.md @@ -1,6 +1,7 @@ --- title: "Scaling InnerSource" subtitle: "How can I scale InnerSource?" +description: "A mindmap to help you use different parts of the InnerSource Commons material to scale InnerSource" type: "community" image: "images/learn/patterns.png" weight: 1 From e098637c9aff7f552fbc8e3ef8e56215cad10455 Mon Sep 17 00:00:00 2001 From: Jeff Bailey <776901+jeffabailey@users.noreply.github.com> Date: Sat, 19 Oct 2024 13:19:47 -0700 Subject: [PATCH 4/6] chore: use hyphen for consistency --- .../scaling/{markmap_content.md => markmap-content.md} | 0 layouts/shortcodes/markmap.html | 8 +++++++- 2 files changed, 7 insertions(+), 1 deletion(-) rename content/en/learn/scaling/{markmap_content.md => markmap-content.md} (100%) diff --git a/content/en/learn/scaling/markmap_content.md b/content/en/learn/scaling/markmap-content.md similarity index 100% rename from content/en/learn/scaling/markmap_content.md rename to content/en/learn/scaling/markmap-content.md diff --git a/layouts/shortcodes/markmap.html b/layouts/shortcodes/markmap.html index 301568d370..daccbd7ac5 100644 --- a/layouts/shortcodes/markmap.html +++ b/layouts/shortcodes/markmap.html @@ -6,9 +6,15 @@ {{ $fileContent := readFile $filePath }} From f3dd0423606731648dd743dc79a9a60312ef6b1d Mon Sep 17 00:00:00 2001 From: Jeff Bailey <776901+jeffabailey@users.noreply.github.com> Date: Sat, 19 Oct 2024 13:21:10 -0700 Subject: [PATCH 5/6] fix: include the renamed md file --- content/en/learn/scaling/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/learn/scaling/_index.md b/content/en/learn/scaling/_index.md index 93c15683ee..f2c0d2e918 100644 --- a/content/en/learn/scaling/_index.md +++ b/content/en/learn/scaling/_index.md @@ -7,4 +7,4 @@ image: "images/learn/patterns.png" weight: 1 --- -{{< markmap path="markmap_content.md" >}} +{{< markmap path="markmap-content.md" >}} From 2be1820d97406da8dda942adada6cc8320f3f620 Mon Sep 17 00:00:00 2001 From: Jeff Bailey <776901+jeffabailey@users.noreply.github.com> Date: Tue, 22 Oct 2024 04:51:05 -0700 Subject: [PATCH 6/6] feat: add content from WG session feat: start map from level 2 feat: add complete Miro content --- content/en/learn/scaling/markmap-content.md | 302 ++++++++++++++++---- 1 file changed, 251 insertions(+), 51 deletions(-) diff --git a/content/en/learn/scaling/markmap-content.md b/content/en/learn/scaling/markmap-content.md index 2dfaf40c2a..8d6b4d4e44 100644 --- a/content/en/learn/scaling/markmap-content.md +++ b/content/en/learn/scaling/markmap-content.md @@ -1,65 +1,265 @@ --- markmap: colorFreezeLevel: 2 + initialExpandLevel: 2 --- +[Managing InnerSource Projects]: https://innersourcecommons.gitbook.io/managing-innersource-projects +[Patterns]: https://patterns.innersourcecommons.org/explore-patterns + # Scaling InnerSource +## InnerSource Program Office + + ### Executive Sponsorship + + ### Dedicated Staffing + + ### InnerSource Program as an InnerSource Project (lead by example) + ## Governance of InnerSource Programs -- Unlock policy constraints -- SDMOs for InnerSource projects -- Accelerated contributions -- Systems -- Roadmap -- Open source principles to fund open source variants of InnerSource -- Technology budget available to support InnerSource -- Repeatable SLAs -- Software/system upgrades + + ### Company leadership support + + ### Unblock policy constraints + + ### SBOMs for InnerSource projects + + #### [Applying OpenChain and SBOMs for InerSource](https://www.youtube.com/watch?v=uI5SGJB9fuw) + + ### Accelerated contributions + + ### Systems + + #### Book [Managing InnerSource Projects](https://innersourcecommons.gitbook.io/managing-innersource-projects), chapters _Infrastructure_ and _Tooling_ + + ### Roadmap + + ### Open source principles to fund open source variants of InnerSource + + ### Technology budget available to support InnerSource + + ### Repeatable SLAs + + ### Software/system upgrades ## [Metrics](https://innersourcecommons.gitbook.io/managing-innersource-projects/measuring) -- Monitoring scale -- Usage -- SLAs -- Readiness -- Contributions -- Accelerated time to market -- Dev time saved -- Developer satisfaction/happiness -- Learning & development / People strategy + + ### Monitoring scale + + ### [Usage](https://innersourcecommons.gitbook.io/managing-innersource-projects/measuring/goals/use_gqm/metrics/usage-count) + + ### SLAs + + ### Readiness + + ### Contributions + + ### Accelerated time to market + + ### Dev time saved + +#### [Cross-Team Project Valuation](https://patterns.innersourcecommons.org/p/crossteam-project-valuation) + + ### Developer satisfaction/happiness + + ### Learning & development / People strategy ## Research -- Career/involvement boost -- Home trap contributions -- Showcase success stories -- Leader/team gamification -- Money -- Better team/company efficiency -- Physical/digital artifacts - -## Project Governance -- Open source readiness -- Treasurers to manage project success -- Integration of related resources into agile, developer curricula -- Project discovery/governance -- Project maturity -- Stakeholder comms (Education on how to InnerSource) -- Reduce arbitrary uniqueness -- Project alignment -- Project value (product association) - -## Value -- Gaining knowledge -- Reducing time to market / cost of development -- Improve developer/employee experience -- Enhance communications -- Learning & development / People strategy -- Accelerate -- Reduce duplication + + ### Career/involvement boost + + ### Home trap contributions + + ### [Showcase success stories](https://innersourcecommons.org/stories/) + + ### Leader/team gamification + + ### [Money](https://innersourcecommons.gitbook.io/managing-innersource-projects/introduction/framework#financial-support) + + ### Better team/company efficiency + + ### Physical/digital artifacts + +## [Project Governance](https://innersourcecommons.gitbook.io/managing-innersource-projects/governance) + + ### Open Source Pathways to Fund Open Source variants of InnerSource + + ### Time/money budget available to support + + #### [30 Day Warranty](https://patterns.innersourcecommons.org/p/30-day-warranty) + + #### [Contracted Contributor](https://patterns.innersourcecommons.org/p/contracted-contributor) + + ### Response SLAs + + ### Security/version upgrades + + #### [Core Team](https://patterns.innersourcecommons.org/p/core-team) + + ### [Open source readiness](https://patterns.innersourcecommons.org/p/base-documentation) + + ### Treasurers to manage project success + + ### Integration of related resources into agile, developer curricula + + ### Project discovery/governance + + ### [Project maturity](https://patterns.innersourcecommons.org/p/maturity-model) + + ### Reduce arbitrary uniqueness + + ### Project alignment + + ### Project value (product association) + + ### Process + + #### Accelerated Contributions + + #### Sprints + + #### Roadmap + + #### Decision Making ## Awareness & Education -- Engage internal project community -- Showcase projects -- Engage internal experts -- Leadership as what a InnerSource project is -- Projects for Internal Enterprise search -- Advisory board for InnerSource + + ### Presence on internal events + + ##### Hackathon + + ##### All-hands + + ##### Leadership meetings + + ##### Presentations + + ### Leadership verbal support + + ### Presence on (internal) Enterprise Search + + ### Awareness on what is InnerSource + + ### External case studies + + ### Communities of Practice + + #### [Dedicated Community Leader](https://patterns.innersourcecommons.org/p/dedicated-community-leader) + + #### [Document your Guiding Principles](https://patterns.innersourcecommons.org/p/document-your-guiding-principles) + + ### Stakeholder comms + + ### Education on how to InnerSource + + #### Integrated in related resources (e.g. Agile, Developer Curriculum) + + ### Project Discoverability + + #### [Portal](https://patterns.innersourcecommons.org/p/innersource-portal) + + ##### Project Maturity + + ##### Project Health + + ##### Project Value (Product Associations) + + #### Communities + + ##### Community Growth + + ##### Community Engagement + + #### Labeling repos for searchability + + #### IDE plugin + + ### Value + + #### Gaining knowledge + + #### Reducing time to market / cost of development + + ##### Software/Content Reuse + + ###### [Cross-Team Project Valuation](https://patterns.innersourcecommons.org/p/crossteam-project-valuation) + + ##### Product/brand alignment + + #### Improve developer/employee experience + + ##### [Adopting InnerSource to Maximize Developer Experience](https://www.youtube.com/watch?v=fOJOacthP8k) + + #### Enhance communications + + #### Learning & development / People strategy + + #### Anecdotes + + ### Reduce duplication + + ### Project Value + + #### Project Adoption + + ##### Reduce arbitrary uniqueness + + + ### Engage internal project community + + #### [Prepare for open source](https://www.youtube.com/watch?v=5_hR3wjaub4) + + #### Advertise Projects + + #### Recruit Contributors + + #### Showcase Projects + + #### Engage internal experts + + ### Leadership as what a InnerSource project is + + ### Projects for Internal Enterprise search + + ### Advisory board for InnerSource + +## Rewards + + ### More Projects Reuse + + ### Career/review level + + ### Social Recognition + + ### Money + + ### Better team/company efficiency + + ### Physical/digital artifacts + +## Templates + + ### README + + ### CONTRIBUTING + + ### New GitHub Projects + + ### InnerSource License + + ### User and Developer Documentatione + + ### Contractor Agreements InnerSource terms + + ### User Experience (contribution path clea from the UI or other user facing resources) + +## Engage external community + + ### Patterns + + ### Case Studies + + ### Sponsorship + + ### Present at events \ No newline at end of file