Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

InnerSource patterns book translation into Brazilian Portuguese #577

Merged
merged 61 commits into from
Aug 30, 2023
Merged
Show file tree
Hide file tree
Changes from 57 commits
Commits
Show all changes
61 commits
Select commit Hold shift + click to select a range
421a5e9
translation patterns 30-day-warranty.md to pt-br.
jrcosta Apr 13, 2023
c3e0924
translation patterns base-documentation.md to pt-br.
jrcosta Apr 14, 2023
d7de8f6
translation patterns common-requirements.md to pt-br.
jrcosta Apr 20, 2023
28f13a0
translation patterns communication-tooling.md to pt-br.
jrcosta Apr 21, 2023
448eca7
translation patterns contracted-contributor.md to pt-br.
jrcosta Apr 21, 2023
3d62356
translation patterns core-team.md to pt-br.
jrcosta Apr 22, 2023
09a08d8
translation patterns crossteam-project-valuation.md to pt-br.
jrcosta Apr 28, 2023
18d2c0e
translation patterns dedicated-community-leader.md to pt-br.
jrcosta Apr 28, 2023
5db19c9
translation patterns document-your-guiding-principles.md to pt-br.
jrcosta Apr 29, 2023
8e716fd
translation patterns gig-marketplace.md to pt-br.
jrcosta Apr 29, 2023
e5229bc
Correction, translation date document-your-guiding-principles.md
jrcosta Apr 29, 2023
26e3d6b
translation patterns innersource-license.md to pt-br.
jrcosta May 5, 2023
9099f68
translation patterns innersource-portal.md to pt-br.
jrcosta Jun 13, 2023
2d0c1ab
translation patterns issue-tracker.md to pt-br.
jrcosta Jun 13, 2023
60d6dc0
translation patterns maturity-model.md to pt-br.
jrcosta Aug 20, 2023
8b58e92
translation patterns praise-participants.md to pt-br.
jrcosta Aug 20, 2023
ed948b2
translation patterns repository-activity-score.md to pt-br.
jrcosta Aug 20, 2023
0f19910
markdown lint fixes
jrcosta Aug 20, 2023
b2c3d8e
translation patterns review-committee.md to pt-br.
jrcosta Aug 20, 2023
8adca63
translation patterns service-vs-library.md to pt-br.
jrcosta Aug 20, 2023
bef0fb5
translation patterns start-as-experiment.md to pt-br.
jrcosta Aug 20, 2023
111ca20
translation patterns transparent-cross-team-decision-making-using-rfc…
jrcosta Aug 21, 2023
6278b23
fix transparent-cross-team-decision-making-using-rfcs.md
jrcosta Aug 21, 2023
f3d4bf2
Merge branch 'InnerSourceCommons:main' into book-ptbr
jrcosta Aug 21, 2023
88db483
translation patterns trusted-committer.md to pt-br.
jrcosta Aug 21, 2023
5e2e70a
Merge branch 'book-ptbr' of github.com:jrcosta/InnerSourcePatterns in…
jrcosta Aug 21, 2023
27eada8
translation templates COMMUNICATION-template.md to pt-br.
jrcosta Aug 21, 2023
241c0b4
translation templates CONTRIBUTING-template.md to pt-br.
jrcosta Aug 21, 2023
c5336b2
translation templates README-template.md to pt-br.
jrcosta Aug 21, 2023
d2dc6af
fix translation folder name
jrcosta Aug 21, 2023
b107b6f
put all translation authors names in patterns
jrcosta Aug 21, 2023
c98cde9
translation titles on patterns
jrcosta Aug 21, 2023
48675dc
translation translation\pt\README.md from pt-br
jrcosta Aug 21, 2023
0847d2d
create folder book/pt and translate files default
jrcosta Aug 21, 2023
fda3759
translation book cover and explore-patterns.md to ptbr
jrcosta Aug 21, 2023
803d776
Writing updated files for the book
jrcosta Aug 22, 2023
0635fb0
Fixing one link, to confirm that this will resolve this link-checker …
spier Aug 22, 2023
3aa960e
Fixing various relative links to patterns and images in the pt-br tra…
spier Aug 22, 2023
e4d6f10
Fixing further links
spier Aug 22, 2023
369d9d2
Link from gitbook sidebar to the translated templates (rather than th…
spier Aug 22, 2023
9aef8fc
Placeolder PATTERNS_HERE must not be translated, so that the generate…
spier Aug 22, 2023
c78301d
Change name of the title section back to 'Title'. The generate_toc.rb…
spier Aug 22, 2023
c3343a1
Writing updated files for the book
spier Aug 22, 2023
76cfc17
Fix link
spier Aug 23, 2023
8c7bbd9
Link to English RFC template
spier Aug 23, 2023
715ae0a
translation patterns 30-day-warranty.md to pt-br.
zilio Apr 13, 2023
4b075b5
Forças instead of Forces
spier Aug 24, 2023
00577ec
Fix link to Forças subtitle
zilio Aug 24, 2023
23f487e
Removed english block already translated
zilio Aug 24, 2023
b8cb50d
fix improper translation of the term donut pattern
zilio Aug 24, 2023
85e4740
fix lint
zilio Aug 24, 2023
c40b2a5
Merge branch 'book-ptbr' of github.com:jrcosta/InnerSourcePatterns in…
spier Aug 26, 2023
99f99e4
Adding CODEONWERS for pt language. Also fixing the same for previous …
spier Aug 26, 2023
8493211
Merge remote-tracking branch 'origin/main' into book-ptbr
spier Aug 27, 2023
93fd3e3
Adapt config for pt book to monorepo approach
spier Aug 27, 2023
d349cd7
Test with GITHUB_TOKEN
spier Aug 27, 2023
f30116c
Adding yuhattor to the catch-all filter in CODEOWNERS
spier Aug 28, 2023
b37126f
Changing the translation folder name to pt-br.
jrcosta Aug 30, 2023
4ef2f72
fix the links for new folder name.
jrcosta Aug 30, 2023
b8d7671
Merge remote-tracking branch 'origin/main' into book-ptbr
spier Aug 30, 2023
8e2dbc6
Revert "Test with GITHUB_TOKEN"
spier Aug 30, 2023
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 9 additions & 5 deletions .github/CODEOWNERS
Validating CODEOWNERS rules …
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,15 @@
# the repo. Unless a later match takes precedence,
# @global-owner1 and @global-owner2 will be requested for
# review when someone opens a pull request.
* @lenucksi @NewMexicoKid @cewilliams @spier @robtuley

# Trying out folder-specific CODEOWNERS permissions, by example of our Japanese book
/translation/ @yuhattor
/book/ @yuhattor
* @lenucksi @NewMexicoKid @cewilliams @spier @robtuley @yuhattor

# These people ar familiar with the translation of our patterns to a specific language:
/translation/ja/ @yuhattor
/book/ja/ @yuhattor
/translation/zh/ @WillemJiang
/book/zh/ @WillemJiang
/translation/pt/ @jrcosta @zilio
/book/pt/ @jrcosta @zilio

# Order is important; the last matching pattern takes the most
# precedence. When someone opens a pull request that only
Expand Down
4 changes: 3 additions & 1 deletion .github/workflows/book.yml
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ jobs:

strategy:
matrix:
language: [en, ja, zh]
language: [en, ja, zh, pt]

steps:
- uses: actions/checkout@v3
Expand All @@ -35,5 +35,7 @@ jobs:

- name: Commit updated toc.md for the book
uses: stefanzweifel/git-auto-commit-action@v4
env:
GITHUB_TOKEN: ${{ github.token }}
with:
commit_message: Writing updated toc.md for the ${{ matrix.language }} book
2 changes: 1 addition & 1 deletion book/en/toc_template.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Instead edit toc_template.md

## Patterns <a id="p"></a>

<<PATTERS_HERE>>
<<PATTERNS_HERE>>

## Appendix

Expand Down
2 changes: 1 addition & 1 deletion book/ja/toc_template.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Instead edit toc_template.md

## パターン<a id="p"></a>

<<PATTERS_HERE>>
<<PATTERNS_HERE>>

## 付録<a id="appendix"></a>

Expand Down
5 changes: 5 additions & 0 deletions book/pt/.gitbook.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
root : ./

structure:
readme: introduction.md
summary: toc.md
31 changes: 31 additions & 0 deletions book/pt/contribute.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# Contribua para este Livro

Deseja tornar este livro melhor? Isso é incrível!

O livro Padrões InnerSource em si é um [projeto de código aberto][repositório] e acolhe qualquer forma de contribuição. Nada é insignificante!

Não importa se deseja nos auxiliar a corrigir erros de gramática/ortografia, melhorar o design ou contribuir com padrões inteiramente novos baseados nas experiências InnerSource que teve em seu local de trabalho. Amamos todas essas contribuições! :)

Se nunca contribuiu para um projeto de código aberto anteriormente, saiba que a comunidade Padrões InnerSource é formada por pessoas amigáveis e é um ambiente seguro para experimentar.

## Antes de Começar

As fontes dos Padrões InnerSource e deste livro estão mantidas em um repositório no GitHub. Portanto, será necessário ter uma conta de usuário no GitHub para fazer edições e sugestões neste livro. Caso não possua uma ainda, visite [github.com](https://github.com) e crie uma conta gratuitamente.

## Diferentes Formas de Contribuir

Aqui estão algumas maneiras pelas quais pode contribuir:

1. Corrigir erros de ortografia, formatação ou outras falhas que notar neste livro.
2. Melhorar o conteúdo de um padrão existente (por exemplo, adicionando uma breve descrição de como está usando um padrão como uma _Instância Conhecida_).
3. Contribuir com um novo padrão, descrevendo como superou desafios relacionados ao InnerSource em sua organização.

Para (1) e (2) acima, pode simplesmente clicar no link **Editar no GitHub** que vê no topo de cada página deste livro. Isso o levará diretamente ao arquivo correspondente em nosso repositório GitHub, onde pode sugerir suas alterações.

Para (3), será necessário clonar o repositório [InnerSourcePatterns][repositório] e adicionar um novo arquivo com o padrão que está sugerindo. Ao fazer contribuições maiores para este livro, revise nosso [CONTRIBUTING.md](../../CONTRIBUTING.md) e também nosso [Manual do Colaborador](../../meta/contributor-handbook.md).

## Licença das Contribuições

O conteúdo deste repositório está licenciado sob [CC-BY-SA-4.0](../../LICENSE.txt). Ao contribuir para este repositório, nos concede (e a todos os outros, também) o direito de usar sua contribuição de acordo com essa licença.

[repositório]: https://github.com/InnerSourceCommons/InnerSourcePatterns
19 changes: 19 additions & 0 deletions book/pt/explore-patterns.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Explore Patterns

Cada vez mais padrões estão sendo contribuídos para este livro pela comunidade InnerSource Commons. Isso é incrível!

Agora, como tornar mais fácil para os leitores descobrirem os padrões que podem ajudá-los em sua situação específica?

Para esse propósito, fornecemos este mapa mental. Ele **classifica os padrões com base nas diferentes fases de um Programa InnerSource** e nos desafios que podem surgir nas respectivas fases.

![Mapa Mental dos Padrões InnerSource](../../pattern-categorization/innersource-program-mind-map.png)

## Melhore este Mapa Mental

Se você notar algo neste mapa mental que pareça errado, por favor [abra uma issue](https://github.com/InnerSourceCommons/InnerSourcePatterns/issues), descrevendo o problema e a correção que deve ser feita.

Além disso, se você tiver outras ideias para melhorar a descoberta desses padrões ou quiser tornar este mapa mental melhor, revise a documentação de nossa abordagem de [Categorização de Padrões](https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/main/pattern-categorization/README.md) e também veja como [contribuir para este livro](contribute.md).

## Referências

A ideia de categorizar os padrões dessa forma é vagamente baseada em uma descrição em [Thoughts on an InnerSource Pattern Language](https://drive.google.com/file/d/13AY8glCOdpLOVuz7cVD6QOB8d2xbHCS1/view) por Tim Yao, Bob Hanmer e Padma Sudarsan (2018). Para detalhes específicos, veja o slide 15 na apresentação.
Binary file added book/pt/innersource-patterns-book-cover.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
67 changes: 67 additions & 0 deletions book/pt/introduction.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
# Introdução

![Capa do Livro Padrões InnerSource](innersource-patterns-book-cover.jpg)

{% hint style="info" %}
Você está lendo uma versão inicial do Livro de Padrões InnerSource e ainda pode encontrar links quebrados, erros de ortografia ou outros problemas.
Por favor, nos ajude a corrigi-los para produzirmos o melhor livro possível :). Saiba como [contribuir para este livro](contribute.md).
{% endhint %}

Bem-vindo ao **Livro de Padrões InnerSource**.

Este livro contém as melhores práticas InnerSource codificadas em um formato específico para facilitar a compreensão, avaliação e aplicação delas em seu contexto. Chamamos esse formato de **padrão**.

A [InnerSource Commons](http://innersourcecommons.org) coletou esses padrões ao longo de muitos anos, publicando os padrões mais maduros neste livro, onde membros da comunidade revisam cada padrão, com pelo menos uma instância conhecida de uso do padrão.

Nesta introdução, explicamos [o que é InnerSource](#o-que-é-innersource), [o que é um padrão](#o-que-são-padrões-innersource) e [Como você pode usar Padrões InnerSource?](#como-você-pode-usar-padrões-innersource) em sua organização.

Se você já está usando InnerSource em sua empresa e deseja contribuir com suas experiências para este livro, adoraríamos [receber suas contribuições](contribute.md)!

## O que é InnerSource?

Definimos InnerSource como:

> O uso de princípios e práticas de código aberto para o desenvolvimento de software dentro dos limites de uma organização.
O InnerSource aproveita as lições aprendidas com o desenvolvimento de software de código aberto e as aplica à forma como as empresas desenvolvem software internamente. À medida que os desenvolvedores se acostumaram a trabalhar em software de código aberto de alta qualidade, surge um forte desejo de trazer essas práticas de volta para dentro da empresa e aplicá-las ao software que as empresas podem relutar em lançar.

Para empresas que constroem principalmente software de código fechado, o InnerSource pode ser uma ótima ferramenta para quebrar barreiras, incentivar e ampliar a colaboração interna, acelerar a integração de novos engenheiros e identificar oportunidades de contribuir com software para o mundo de código aberto.

## O que são Padrões InnerSource?

Padrões são uma forma de descrever uma solução repetível e comprovada para um problema dentro de um contexto. Os padrões seguem uma forma simples que auxilia durante a implementação de uma solução para entender as restrições do problema, compreender as forças que você precisa equilibrar e o contexto resultante - a situação criada pela aplicação da solução.

Os padrões podem fornecer uma maneira para os participantes da InnerSource Commons compartilharem informações de forma concisa, melhorando a prática do InnerSource. Os padrões são divididos em Título, Declaração do Problema, Contexto, Forças e Soluções como suas principais seções.

* [`O que são padrões?` Vídeos no Youtube](http://bit.ly/innersource_patterns_videos) - Assista a uma série de vídeos no Youtube de 2-5 minutos explicando Padrões InnerSource.
* [Webinar de Discussão de Padrões](https://youtu.be/i-0IVhfRVFU) - Realizamos um webinar em 16 de março de 2017 para discutir ao vivo um *donut pattern*[^1] (vá para 24:30 para a discussão). Isso ilustra o processo de revisão que seguimos. Veja também o [Webinar O'Reilly de 1 de junho de 2017 sobre Padrões InnerSource](http://www.oreilly.com/pub/e/3884).
* [Modelo de Padrão](../../meta/pattern-template.md) - Veja um padrão InnerSource esqueleto para ter uma ideia do que é necessário para criar um novo padrão!
* [Introdução aos Padrões InnerSource (apresentação do Fall Summit 2016)](https://drive.google.com/open?id=0B7_9iQb93uBQbnlkdHNuUGhpTXc) - *Tim Yao e Padma Sudarsan* (PDF). Fundo e exemplos detalhados de padrões - Entenda detalhadamente por que e como interagir com nossos padrões. Veja também a [Introdução aos Padrões InnerSource (Fall Summit 2017)](https://drive.google.com/open?id=0B7_9iQb93uBQWmYwMFpyaGh4OFU) *Tim Yao e Bob Hanmer* (PDF).

## Como você pode usar Padrões InnerSource?

Os padrões devem ser usados com cuidado. Eles não podem ser aplicados indiscriminadamente. Na maioria dos casos, você precisará adaptar a solução fornecida à sua situação; mas as informações dadas no padrão, definindo o contexto (restrições imutáveis) e as forças (restrições que podem ser alteradas e equilibradas entre si), devem ajudá-lo a fazer isso. Note que você também precisará determinar se existem restrições adicionais (contexto da empresa e forças da empresa) que se aplicam à sua empresa/organização específica e que devem ser adicionadas ao padrão (como um tipo de filtro). Essas restrições adicionais podem exigir etapas de solução adicionais a serem aplicadas.

A forma do padrão é útil para descrever soluções comprovadas, mas também pode ser usada para *brainstorming de novas soluções* onde os padrões ainda não estão estabelecidos. Isso ocorre porque a anatomia de um padrão fornece um framework para pensar em um problema de maneira estruturada. Você também pode criar um *donut pattern* (preenchendo os campos de problema, contexto, forças e contexto resultante, mas deixando a solução em branco) como uma maneira de pedir ajuda à comunidade da InnerSource Commons (para encontrar uma solução comprovada ou para gerar ideias para tentar).

## Como Contribuir?

Por favor, consulte: [Contribuir para este livro](./contribute.md)

## Créditos

Este livro é o resultado de muitos anos de trabalho de inúmeros [Contribuidores de Código Aberto](https://github.com/InnerSourceCommons/InnerSourcePatterns/graphs/contributors) de todo o mundo. Sua disposição em compartilhar abertamente os desafios que enfrentaram em suas empresas e como o InnerSource os ajudou a enfrentar esses desafios torna este livro um recurso valioso para outros em sua jornada InnerSource.

Queremos mencionar especificamente o Grupo de Trabalho InnerSource Patterns. Eles têm nutrido a qualidade dos Padrões InnerSource e ajudaram outros a contribuir. Por último, eles também compilaram uma seleção de padrões disponíveis neste livro.

A imagem de capa deste livro foi criada por [Sebastian Spier](https://spier.hu) e adaptada a partir de uma imagem de [Tony Hisgett - Alhambra 6](https://www.flickr.com/photos/hisgett/29345405788/), disponível sob [CC BY 2.0](https://creativecommons.org/licenses/by/2.0/).

**Obrigado a todos os contribuidores! E feliz Dia InnerSource :)**

## Licenciamento

![Licença Creative Commons](https://i.creativecommons.org/l/by-sa/4.0/88x31.png)

InnerSourcePatterns por [InnerSourceCommons.org](http://innersourcecommons.org) está licenciado sob uma [Licença Internacional Creative Commons Attribution-ShareAlike 4.0](http://creativecommons.org/licenses/by-sa/4.0/).

[^1]: *Donut pattern* não possui tradução direta para português. No contexto em que está utilizado refere-se a um padrão ainda não está totalmente definido, com o campo solução ainda pendente de discussões.
Loading