Skip to content

Commit 312d8a5

Browse files
authored
Merge branch 'InnerSourceCommons:main' into new-code-of-conduct-pattern
2 parents 0ce1892 + dd556f7 commit 312d8a5

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

46 files changed

+257
-169
lines changed

Diff for: .github/workflows/book.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ jobs:
1818
language: [en, ja, zh, pt-br, gl]
1919

2020
steps:
21-
- uses: actions/checkout@v3
21+
- uses: actions/checkout@v4
2222

2323
- uses: ruby/setup-ruby@v1
2424
with:
@@ -33,7 +33,7 @@ jobs:
3333
echo "Generated book for: ${{ matrix.language }}" >> $GITHUB_STEP_SUMMARY
3434
3535
- name: Commit updated toc.md for the book
36-
uses: stefanzweifel/git-auto-commit-action@v4
36+
uses: stefanzweifel/git-auto-commit-action@v5
3737
with:
3838
commit_message: Writing updated toc.md for the ${{ matrix.language }} book
3939
branch: ${{ github.head_ref }}

Diff for: .github/workflows/generate-mindmap.yml

+4-4
Original file line numberDiff line numberDiff line change
@@ -26,11 +26,11 @@ jobs:
2626
folder: [".", "./gl", "./pt-br"]
2727

2828
steps:
29-
- uses: actions/checkout@v3
29+
- uses: actions/checkout@v4
3030
- name: Use Node.js
31-
uses: actions/setup-node@v3
31+
uses: actions/setup-node@v4
3232
with:
33-
node-version: 16
33+
node-version: 20
3434
cache: 'npm'
3535
cache-dependency-path: pattern-categorization/package-lock.json
3636
- name: Install Node.js dependencies
@@ -49,6 +49,6 @@ jobs:
4949
- name: Reduce Screenshot Size (PNG)
5050
run: npx optipng ${{ matrix.folder }}/innersource-program-mind-map.png
5151
- name: Commit Changes
52-
uses: stefanzweifel/git-auto-commit-action@v4
52+
uses: stefanzweifel/git-auto-commit-action@v5
5353
with:
5454
commit_message: Re-creating markmap and screenshot

Diff for: .github/workflows/i18n-consistency-checker.yaml

+1-1
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ jobs:
1717
matrix:
1818
language: [ja, zh, pt-br, gl]
1919
steps:
20-
- uses: actions/checkout@v3
20+
- uses: actions/checkout@v4
2121
with:
2222
fetch-depth: '0'
2323
- name: Check consistency and create issue

Diff for: .github/workflows/link-checker-prs.yml

+3-3
Original file line numberDiff line numberDiff line change
@@ -15,21 +15,21 @@ jobs:
1515
linkChecker:
1616
runs-on: ubuntu-latest
1717
steps:
18-
- uses: actions/checkout@v3
18+
- uses: actions/checkout@v4
1919
with:
2020
fetch-depth: 0
2121

2222
- name: Get changed files
2323
id: changed-files
24-
uses: tj-actions/changed-files@v32
24+
uses: tj-actions/changed-files@v44
2525

2626
- name: Filter markdown files only
2727
run: |
2828
md_files=`find ${{ steps.changed-files.outputs.all_changed_files }} -maxdepth 0 -name "*.md" | tr '\n' ' '`
2929
echo "MARKDOWN_FILES=$md_files" >> $GITHUB_ENV
3030
3131
- name: Restore lychee cache
32-
uses: actions/cache@v3
32+
uses: actions/cache@v4
3333
with:
3434
path: .lycheecache
3535
key: cache-lychee-${{ github.sha }}

Diff for: .github/workflows/link-checker.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -14,10 +14,10 @@ jobs:
1414
linkChecker:
1515
runs-on: ubuntu-latest
1616
steps:
17-
- uses: actions/checkout@v3
17+
- uses: actions/checkout@v4
1818

1919
- name: Restore lychee cache
20-
uses: actions/cache@v3
20+
uses: actions/cache@v4
2121
with:
2222
path: .lycheecache
2323
key: cache-lychee-${{ github.sha }}

Diff for: .github/workflows/lint-patterns.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@ jobs:
1818
validate:
1919
runs-on: ubuntu-latest
2020
steps:
21-
- uses: actions/checkout@v3
21+
- uses: actions/checkout@v4
2222
- name: Problem Matcher for markdownlint-cli
23-
uses: xt0rted/markdownlint-problem-matcher@v2
23+
uses: xt0rted/markdownlint-problem-matcher@v3
2424
- name: Lint pattern files (markdown)
2525
uses: avto-dev/markdown-lint@v1
2626
with:

Diff for: .github/workflows/markdownlint.yml

+3-3
Original file line numberDiff line numberDiff line change
@@ -20,11 +20,11 @@ jobs:
2020
runs-on: ubuntu-latest
2121

2222
steps:
23-
- uses: actions/checkout@v3
23+
- uses: actions/checkout@v4
2424
- name: Use Node.js
25-
uses: actions/setup-node@v3
25+
uses: actions/setup-node@v4
2626
with:
27-
node-version: 16
27+
node-version: 20
2828
- name: Run Markdownlint
2929
run: |
3030
echo "::add-matcher::.github/workflows/markdownlint-problem-matcher.json"

Diff for: .github/workflows/vale.yml

+4-1
Original file line numberDiff line numberDiff line change
@@ -9,13 +9,16 @@ on:
99
pull_request:
1010
branches:
1111
- main
12+
workflow_dispatch:
13+
schedule:
14+
- cron: '3 2 1 * *'
1215

1316
jobs:
1417
vale:
1518
runs-on: ubuntu-latest
1619

1720
steps:
18-
- uses: actions/checkout@v3
21+
- uses: actions/checkout@v4
1922

2023
- name: Vale Linting
2124
uses: errata-ai/vale-action@reviewdog

Diff for: README.md

+1
Original file line numberDiff line numberDiff line change
@@ -83,6 +83,7 @@ Our mission
8383
* [Transitioning Contractor Code to InnerSource Model](/patterns/1-initial/transitioning-contractor-code-to-innersource-model.md) - *Contract developers are often not motivated to engage in InnerSource activities, which may be beyond the scope of their contract. This pattern describes how you can focus on transitioning the contractor project after the fact to an InnerSource project by setting expectations for specific InnerSource-related deliverables as part of the overall project delivery.*
8484
* [Incubator Pipeline](/patterns/1-initial/incubator-pipeline.md) - *A team maintaining a widely shared code library wants to accept contributions from other teams, without lowering the overall quality of their library. Therefore the shared library team uses an incubator pipeline to set a lower bar for contributions to enter and a higher bar to exit and become a top-level unit in the library.*
8585
* [InnerSource Customer Interview Questions](/patterns/1-initial/innersource-customer-interview-questions.md) - *An organization has decided to create an InnerSource program but are unsure which issues they should address first. Using a customer interview will help evaluate pain points across the organization, to prioritize the areas where InnerSource will have the biggest positive impact.*
86+
* [Creating an InnerSource Strategy](/patterns/1-initial/creating_an_innersource_strategy.md) - *Sometimes, it is difficult to convince people of the relevance of InnerSource for your organization and/or to get support from management. Creating an InnerSource strategy, that connects your InnerSource approach and activities to the goals and the overall strategy of your organization, can help in this regard.*
8687

8788
<!--
8889
NOTE: The 'Initial' Patterns below don't have a Patlet yet, which is essential for readers to quickly browse our patterns.

Diff for: book/en/toc.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Instead edit toc_template.md
3030
* [Extensions for Sustainable Growth](../../patterns/2-structured/extensions-for-sustainable-growth.md) - An InnerSource project is receiving too many contributions, making maintenance difficult. By offering an extension mechanism outside of the core project, the maintainers enable scaling of project capabilities with minimal cost and maintenance overhead.
3131
* [Gig Marketplace](../../patterns/2-structured/gig-marketplace.md) - Establish a marketplace by creating an intranet website that lists specific InnerSource project needs as "Gigs" with explicit time and skill requirements. This will enable managers to better understand their employee’s time commitment and professional benefits thereby increasing the likelihood of garnering approval to make InnerSource contributions.
3232
* [Group Support](../../patterns/2-structured/group-support.md) - What happens if a team or individual no longer supports an InnerSource project? Keep the project alive by forming a group of interested individuals.
33-
* [InnerSource License](../../patterns/2-structured/innersource-license.md) - Two legal entities that belong to the same organization want to share software source code with each other but they are concerned about the implications in terms of legal liabilities or cross-company accounting.
33+
* [InnerSource License](../../patterns/2-structured/innersource-license.md) - Two legal entities that belong to the same organization want to share software source code with each other but they are concerned about the implications in terms of legal liabilities or cross-company accounting. An InnerSource License provides a reusable legal framework for the sharing of source code within the organization. This opens up new collaboration options, and makes the rights and obligations of the involved legal entities explicit.
3434
* [InnerSource Portal](../../patterns/2-structured/innersource-portal.md) - Potential contributors cannot easily discover InnerSource projects that they are interested in. By creating an intranet website that indexes all available InnerSource project information you enable contributors to learn about projects that might interest them and InnerSource project owners to attract an outside audience.
3535
* [Issue Tracker Use Cases](../../patterns/2-structured/issue-tracker.md) - The InnerSource host team fails to make not only plans and progress but also context for changes transparent. This is solved by increasing the use cases for the project issue tracker to also serve brainstorming, implementation discussion, and feature design.
3636
* [Maturity Model](../../patterns/2-structured/maturity-model.md) - Teams have started adopting InnerSource. The practice is spreading to multiple departments. However, the understanding of what constitutes an InnerSource project varies. The solution is to provide a maturity model to allow for teams to go through a self check and discover patterns and practices that they are not yet aware of.

Diff for: book/gl/introduction.md

+10-10
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
![Modelos InnerSource](innersource-patterns-book-cover.png)
44

55
{% hint style="info" %}
6-
Vostede está a ler unha versión preliminar do libro *Modelos InnerSource: Guía das mellores prácticas por casos: Fáciles de entender, avaliar e aplicar*, polo que é posible que algunhas ligazóns non funcionen, ou atope algún erro. Pode axudarnos a corrixilos e así poder ofrecer o mellor libro posible, se escolle facer [contribucións](contribute.md) a este libro.
6+
Vostede está a ler unha versión preliminar do libro *Modelos InnerSource: Guía das mellores prácticas por casos: Fáciles de entender, avaliar e aplicar*, polo que é posible que algunhas ligazóns non funcionen, ou atope algún erro. Pode axudarnos a corrixilos, e así poder ofrecer o mellor libro posible, se escolle facer [contribucións](contribute.md) a este libro.
77
{% endhint %}
88

99
Benvido ao libro **Modelos de InnerSource**.
@@ -14,7 +14,7 @@ Este libro contén as mellores prácticas de InnerSource debulladas nun formato
1414

1515
Nesta introdución explicamos [que é InnerSource](#que-é-innersource), [que é un modelo](#que-son-os-modelos-innersource) e [como empregar eses modelos](#como-pode-empregar-os-modelos-innersource) na súa organización.
1616

17-
Se xa está a empregar InnerSource na súa empresa e quere contribuír aportando experiencias a este libro, encantaríanos [recibir as súas contribucións](./contribute.md)
17+
Se xa está a empregar InnerSource na súa empresa e quere contribuír achegando experiencias a este libro, encantaríanos [recibir as súas contribucións](./contribute.md)
1818

1919
## Que é InnerSource?
2020

@@ -28,34 +28,34 @@ Para as empresas que crean na súa meirande parte software de código pechado, I
2828

2929
## Que son os modelos InnerSource?
3030

31-
Os modelos son unha forma de describir unha solución probada e repetible para un problema nun contexto concreto. Os modelos empregan un formato sinxelo co que, na propia aplicación da solución, axudan a comprender as limitacións do problema, os aspectos que mellorar e o contexto resultante; é dicir, a nova situación xerada trala aplicación desta solución.
31+
Os modelos son unha forma de describir unha solución probada e repetible para un problema nun contexto concreto. Os modelos empregan un formato sinxelo co que, na propia aplicación da solución, axudan a comprender as limitacións do problema, os aspectos que mellorar e o contexto resultante; é dicir, a nova situación xerada tras a aplicación desta solución.
3232

3333
Os modelos poden proporcionar aos/ás participantes de InnerSource Commons un medio polo que compartir información de xeito conciso, para mellorar a práctica InnerSource. Algunhas das seccións principais destes modelos son: Título, Problema, Contexto, Aspectos que mellorar e Solucións.
3434

35-
* [Vídeos de Youtube sobre que son os modelos](http://bit.ly/innersource_patterns_videos): Visualice esta serie de vídeos de YouTube de entre 2 e 5 minutos, na que se explican os modelos InnerSource.
36-
* [Webinario sobre os modelos](https://youtu.be/i-0IVhfRVFU): O 16 de marzo de 2017 levouse a cabo este webinario no que se debateu en vivo un modelo donut (minuto 24:30). É un exemplo do proceso de revisión que seguimos. Tamén pode consultar o [webinario sobre modelos InnerSource de O’Reilly do 1 de xuño de 2017](http://www.oreilly.com/pub/e/3884).
37-
* [Prototipo de modelo](../../translation/gl/templates/pattern-template.md): Observe a estrutura dun modelo InnerSource para ter unha idea do que acontece nun modelo novo.
35+
* [Vídeos de Youtube sobre que son os modelos](http://bit.ly/innersource_patterns_videos): visualice esta serie de vídeos de YouTube de entre 2 e 5 minutos, na que se explican os modelos InnerSource.
36+
* [Webinario sobre os modelos](https://youtu.be/i-0IVhfRVFU): o16 de marzo de 2017 levouse a cabo este webinario no que se debateu en vivo un modelo donut (minuto 24:30). É un exemplo do proceso de revisión que seguimos. Tamén pode consultar o [webinario sobre modelos InnerSource de O’Reilly do 1 de xuño de 2017](http://www.oreilly.com/pub/e/3884).
37+
* [Prototipo de modelo](../../translation/gl/templates/pattern-template.md): observe a estrutura dun modelo InnerSource para ter unha idea do que acontece nun modelo novo.
3838
* [Introdución aos modelos InnerSource (presentación en inglés do cumio de outono de 2016)](https://drive.google.com/open?id=0B7_9iQb93uBQbnlkdHNuUGhpTXc), de Tim Yao e Padma Sudarsan (PDF). Expón os antecedentes e algúns exemplos de modelos, e permitiralle comprender en detalle os motivos polos que facer uso dos nosos modelos e como facelo. Consulte tamén a [Introdución aos modelos InnerSource (do cume de outono de 2017)](https://drive.google.com/open?id=0B7_9iQb93uBQWmYwMFpyaGh4OFU) de Tim Yao e Bob Hanmer (PDF).
3939

4040
## Como pode empregar os modelos InnerSource?
4141

4242
Os modelos deben empregarse coidadosamente. Non poden aplicarse de xeito indiscriminado. Na maioría dos casos, vostede necesitará adaptar unha solución á súa situación particular; mais a información proporcionada no modelo, que define o contexto (os límites inamovibles) e os aspectos que mellorar (os límites que poden cambiar e equilibrarse entre si), debería servir de axuda para poñela en práctica. Teña en conta que tamén deberá determinar se existen limitacións adicionais (o contexto e os aspectos que queira mellorar a empresa) que se apliquen á súa compañía/organización en particular e deban engadirse ao modelo (como se fose unha especie de filtro). Estas limitacións adicionais poden chegar a requirir pasos adicionais para chegar a unha solución.
4343

44-
O impreso do modelo é útil para describir solucións probadas, pero tamén se pode empregar para xerar ideas sobre novas solucións onde aínda non se estableceron modelos. Isto débese a que a anatomía dun modelo proporciona un marco de traballo para pensar sobre un problema dun xeito estruturado. Vostede tamén pode crear un *modelo de donut* (completando os campos de problema, contexto, aspectos que mellorar e contexto resultante; pero deixando a solución en branco) como unha forma de pedir axuda á comunidade InnerSource Commons (para encontrar unha solución comprobada ou para aportar ideas sobre que cousas probar).
44+
O impreso do modelo é útil para describir solucións probadas, pero tamén se pode empregar para xerar ideas sobre novas solucións onde aínda non se estableceron modelos. Isto débese a que a anatomía dun modelo proporciona un marco de traballo para pensar sobre un problema dun xeito estruturado. Vostede tamén pode crear un *modelo de donut* (completando os campos de problema, contexto, aspectos que mellorar e contexto resultante; pero deixando a solución en branco) como unha forma de pedir axuda á comunidade InnerSource Commons (para encontrar unha solución comprobada ou para achegar ideas sobre que cousas probar).
4545

4646
## Como contribuír?
4747

48-
Consulte: [Como contribuír a este libro](./contribute.md).
48+
Consulte: [como contribuír a este libro](./contribute.md).
4949

5050
## Créditos
5151

52-
Este libro é o resultado de moitos anos de traballo de incontables [contribuidores/as de software libre](https://github.com/InnerSourceCommons/InnerSourcePatterns/graphs/contributors) de todo o mundo. A súa vontade de compartir abertamente os desafíos que afrontaron as súas empresas e o xeito no que InnerSource lles axudou a abordar eses desafíos, fan deste libro un recurso valioso para calquera que inicie o seu percorrido InnerSource.
52+
Este libro é o resultado de moitos anos de traballo de incontables [contribuidores/as de software libre](https://github.com/InnerSourceCommons/InnerSourcePatterns/graphs/contributors) de todo o mundo. A súa vontade de compartir abertamente os desafíos que afrontaron as súas empresas e o xeito no que InnerSource os axudou a abordar eses desafíos, fan deste libro un recurso valioso para calquera que inicie o seu percorrido InnerSource.
5353

5454
Queremos facer unha mención especial ao InnerSource Patterns Working Group, que nutriu a calidade dos modelos e axudou a outros/as a facer contribucións. E tamén compilou a selección de modelos dispoñibles neste libro.
5555

5656
A imaxe do título do libro foi creada por [Sebastian Spier](https://spier.hu) e adaptada dunha imaxe de [Tony Hisgett - Alhambra 6](https://www.flickr.com/photos/hisgett/29345405788/), dispoñible baixo a licenza [CC BY 2.0](https://creativecommons.org/licenses/by/2.0/).
5757

58-
**Moitas grazas a tódolos/as contribuidores/as! E feliz día InnerSource. :)**
58+
**Moitas grazas a todos os/as contribuidores/as! E feliz día InnerSource. :)**
5959

6060
## Licenza
6161

0 commit comments

Comments
 (0)