Convert to page new content

Author: lpirola

content/pt-br/docs/examples.md

@@ -1,15 +1,98 @@
 ---
-title: Examples
-description: See your project in action!
-date: 2017-01-05
+title: Colaboração com múltiplos repositório no git
+description: 
+date: 2025-03-26
 weight: 3
 ---
 
-{{% pageinfo %}}
+## CONTEXTO E CONFIGURAÇÃO DO AMBIENTE
 
-This is a placeholder page that shows you how to use this template site.
+• Projeto Principal e Submódulos:
+ – O repositório principal (main) contém a estrutura global do software.
+ – Plugins e temas são mantidos em repositórios separados e integrados como submódulos.
+ – Para clonar o projeto com todos os submódulos configurados, utilize:
+  • git clone --recurse-submodules [URL do repositório principal]
+ Ou, se já tiver clonado sem submódulos, execute:
+  • git submodule init
+  • git submodule update 
 
-{{% /pageinfo %}}
+• Ambiente de Desenvolvimento:
+ – Configure suas ferramentas (IDE, terminal, etc.) para operacionalizar tanto o repositório principal quanto os submódulos, já que estes podem ter suas próprias dependências e configurações específicas. 
 
-Do you have any example **applications** or **code** for your users in your repo
-or elsewhere? Link to your examples here.
+## FLUXO DE DESENVOLVIMENTO TRUNK
+
+Com o desenvolvimento trunk, a ênfase é na integração rápida e frequente no repositório principal, ou seja, na branch main: 
+
+• Branch Principal (Main):
+ – A branch main representa a base de integração contínua e o código de produção.
+ – Todas as mudanças aprovadas e testadas são integradas diretamente na main. 
+
+• Branches Temporárias para Features ou Correções:
+ – Ao desenvolver uma nova funcionalidade ou corrigir um problema, crie uma branch de curta duração a partir da main.
+ – Exemplos de nomenclatura: feature/minha-nova-funcionalidade ou fix/descricao-curta
+ – Essas branches devem ser integradas ao main o mais rápido possível para minimizar divergências. 
+
+• Integração Contínua e Entrega Contínua (CI/CD):
+ – Os desenvolvedores integram suas mudanças frequentemente na main.
+ – Testes automatizados garantem que a main esteja sempre estável e pronta para produção. 
+
+## INTEGRAÇÃO DOS SUBMÓDULOS
+
+Os submódulos permitem que repositórios independentes (plugins e temas) sejam integrados ao projeto principal. No fluxo com desenvolvimento no trunk, as operações com submódulos seguem os mesmos princípios de rapidez e integração contínua: 
+
+• Desenvolvimento nos Submódulos:
+ – Se uma funcionalidade ou correção impactar um plugin ou tema, o desenvolvedor poderá criar uma branch temporária dentro do repositório do submódulo.
+ – Após o desenvolvimento e os testes, integre a mudança rapidamente na branch principal do submódulo (ou na branch de integração rápida, conforme o fluxo interno do time). 
+
+• Atualizando o Submódulo no Repositório Principal:
+ – Assim que o submódulo for atualizado (após merge da branch temporária), o repositório principal precisa apontar para o novo commit:
+  1. Acesse o diretório do submódulo e execute git pull para obter as últimas mudanças.
+  2. No repositório principal, adicione o diretório do submódulo com git add para atualizar sua referência.
+  3. Realize um commit no repositório principal para registrar a atualização da referência.
+ – Dessa forma, ao integrar mudanças na main, todos os colaboradores terão a referência atualizada dos plugins/temas. 
+
+## PROCESSO DE INTEGRAÇÃO, TESTES E PULL REQUESTS
+
+Mesmo com a integração contínua na branch main, o uso de pull requests (PRs) continua sendo uma excelente prática para revisão do código: 
+
+• Criação da Branch Temporária:
+ – A partir da main, crie uma branch de feature ou fix.
+ – Desenvole a nova funcionalidade ou correção tanto no repositório principal quanto, se necessário, nos submódulos. 
+
+• Pull Request para Integração:
+ – Ao terminar o desenvolvimento, abra um PR da branch temporária para a main.
+ – Descreva as mudanças realizadas, incluindo atualizações dos submódulos, se aplicável.
+ – Colegas realizam revisões de código para garantir qualidade e evitar problemas. 
+
+• Testes Automatizados e integração (CI/CD):
+ – Ao abrir o PR, os testes automatizados (unitários, de integração e outros) são executados para assegurar a integridade da main.
+ – Confirme que as referências dos submódulos correspondem a commits validados e aprovados. 
+
+• Merge na Main:
+ – Após a aprovação do PR e com todos os testes passando, integre a branch temporária à main rapidamente.
+ – Essa prática assegura que o código da main esteja sempre atualizado e estável. 
+
+## DESENVOLVIMENTO TRUNK COM SUBMÓDULOS
+
+• Integração Rápida e Frequente:
+ – As mudanças são integradas na main diversas vezes ao dia, evitando grandes divergências e conflitos. 
+
+• Simplicidade no Gerenciamento de Branches:
+ – Com uma única branch principal (main), o fluxo se torna mais simples e menos burocrático, eliminando a necessidade de branches longas como develop ou release. 
+
+• Feedback Imediato:
+ – Sistemas de CI/CD permitem identificar e corrigir problemas rapidamente. 
+
+• Atualização Ágil dos Submódulos:
+ – A rápida integração permite que os submódulos sejam atualizados constantemente, mantendo tudo em sincronia. 
+
+## CONSIDERAÇÕES FINAIS
+
+• Cultura de Integração Contínua:
+ – Os desenvolvedores devem integrar continuamente suas mudanças na main, mantendo uma base de código comum e minimizando divergências. 
+
+• Comunicação e Colaboração:
+ – Manter uma comunicação ativa é fundamental para que as mudanças em submódulos não causem impactos inesperados no software principal. 
+
+• Ferramentas de CI/CD:
+ – Garanta que sua pipeline de integração contínua esteja configurada para executar testes a cada merge, tanto no repositório principal quanto nos submódulos.