CNN Brasil Docs

Autor: Pedro Romio

Objetivo

Definir o fluxo padrão de versionamento e entrega de código, garantindo organização, revisão adequada e passagem pelos ambientes.

---

1. Criar branch da tarefa

Sempre iniciar a partir da master atualizada:

git checkout master
git pull origin master

Criar a branch da tarefa:

git checkout -b 9999

---

2. Desenvolvimento

Realizar as alterações normalmente.

Salvar e versionar:

git add .
git commit -m "Descrição da alteração"

Enviar a branch:

git push origin 9999

---

3. Fluxo de PRs

A mesma branch (9999) deve ser utilizada para promover a mudança entre os ambientes.

3.1 PR → staging

• resolver conflitos, se necessário
• time revisa e aprova
• merge em staging

---

3.2 PR → preprod

• resolver conflitos, se necessário
• time revisa e aprova
• merge em preprod

---

3.3 PR → master

• resolver conflitos, se necessário
• time da CNN revisa e aprova
• merge em master

---

4. Resolução de conflitos (boa prática)

Antes de abrir ou atualizar um PR, garantir que sua branch está atualizada com o destino:

Exemplo com staging:

git checkout 9999
git pull origin staging

Resolver conflitos localmente, se houver, e enviar novamente:

git add .
git commit -m "fix: resolve conflitos"
git push origin 9999

---

5. Resumo do fluxo

master → cria branch → desenvolvimento → PR staging → PR preprod → PR master

A branch nasce da master, mas a entrega passa por todos os ambientes antes de chegar em produção.

---

6. Boas práticas

- Sempre atualizar a master antes de criar branch
- Usar nomes de branch relacionados à task (ex: 9999)
- Commits claros e objetivos
- Resolver conflitos antes da revisão
- Não abrir PR com conflitos pendentes