Skip to content

Commit

Permalink
InnerSource patterns book translation into Brazilian Portuguese (#577)
Browse files Browse the repository at this point in the history
Initial translation of patterns to into Brazilian Portuguese
* Using pt-b as translation folder name
* Putting all translation authors names in patterns
* Adding CODEOWNERS for pt-br language. Also fixing the same for previous languages (ja/zh).
* Adapt config for pt-br book to monorepo approach

---------

Co-authored-by: jrcosta <[email protected]>
Co-authored-by: Humberto Zilio <[email protected]>
Co-authored-by: DanielleAlmeida <[email protected]>
Co-authored-by: Sebastian Spier <[email protected]>
  • Loading branch information
5 people authored Aug 30, 2023
1 parent 99a58da commit b6db909
Show file tree
Hide file tree
Showing 38 changed files with 2,709 additions and 10 deletions.
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
2 changes: 1 addition & 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 Down
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-br/.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-br/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-br/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-br/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-br/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

0 comments on commit b6db909

Please sign in to comment.