Pull requests e o GitHub flow
Trabalhe em branches, abra pull requests fáceis de revisar e escolha entre merge, squash e rebase.
- Seguir o GitHub flow: branch, commit, abrir um pull request, revisar, fazer merge
- Escrever um pull request fácil de revisar e usar drafts e issues vinculadas
- Comparar merge commits, squash merges e rebase merges
Um pull request (PR) diz: “aqui estão alguns commits na minha branch - por favor, revise-os e puxe-os para a main.” Ele é o coração da colaboração no GitHub. A maioria das equipes segue o GitHub flow:
- A
mainestá sempre pronta para deploy. - Crie uma branch para cada mudança:
fix/wall-clipping,feature/boss-battles. - Faça commit e push para a branch.
- Abra um pull request cedo - como draft se ele não estiver pronto.
- As verificações automáticas rodam, e os colegas revisam e discutem.
- Faça merge na
maine depois apague a branch.
1git switch -c fix/wall-clipping # 1. a branch for the change
2# ...edit, test...
3git commit -am "Stop the hero clipping through walls after a dash"
4git push -u origin fix/wall-clipping # 2. publish the branch
5gh pr create --fill --draft # 3. open a draft PR (or use the button on GitHub)
6gh pr ready # 4. mark it ready for review
7gh pr merge --squash --delete-branch # 5. after approval and green checksExperimente
Até 15 XPA vida de um pull request
Acompanhe o seu primeiro pull request no Dungeon Dash do push até o merge. Preveja o que acontece em cada passo antes de revelá-lo.
Um pull request que as pessoas querem revisar
- Mantenha-o pequeno e focado. Uma mudança por PR. Os revisores pegam muito mais problemas em 100 linhas do que em 1.000.
- Explique o porquê, não só o quê: o problema, a abordagem, qualquer coisa de que você não tenha certeza e como você testou. Capturas de tela para mudanças visuais.
- Vincule a issue com uma palavra-chave de fechamento.
- Revise o seu próprio diff primeiro - você vai pegar prints de depuração esquecidos.
- Abra um draft cedo para receber feedback sobre a direção antes de polir a coisa errada.
Um arquivo .github/pull_request_template.md preenche a descrição de todo novo PR com um checklist.
Três formas de fazer merge
Suponha que a main tenha os commits A, B, e a sua branch acrescente X, Y, Z:
| Método | main resultante | Bom para |
|---|---|---|
| Merge commit | A, B, X, Y, Z, mais um merge commit M que os une | manter o histórico completo e onde as branches se juntaram |
| Squash and merge | A, B e depois um novo commit S com as mudanças de X+Y+Z | um histórico limpo e linear, com um commit por PR |
| Rebase and merge | A, B, X′, Y′, Z′ - cópias dos seus commits reaplicadas por cima | um histórico linear que mantém cada commit |
O squash merge é popular porque os commits bagunçados de “fix typo” desaparecem. O porém: os commits da sua branch não estão mais na main (S é um commit novo), então apague a branch depois do merge em vez de continuar construindo em cima dela. As configurações do repositório controlam quais métodos são permitidos.
Principais conclusões
GitHub flow: branch, commit, push, abrir um PR, passar pelas verificações e pela revisão, fazer merge, apagar a branch.
PRs pequenos e focados, que explicam o porquê e vinculam a sua issue, são revisados mais rápido e melhor.
PRs em draft convidam feedback cedo; fazer push na branch atualiza o PR.
Merge commits mantêm tudo, squash dá um commit por PR, rebase mantém os commits, mas lineariza.
Quiz da aula
7 perguntas · aprovação com 5 acertos · até 50 XP
Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.
Pratique: automatize tarefas do GitHub com Python
O trabalho real no GitHub envolve muita automação pequena: conferir CODEOWNERS, expandir matrizes de build, atualizar versões, ler a API. Escreva esses utilitários em Python e execute-os com entradas de exemplo, localmente no navegador e sem precisar de conta no GitHub.
Simule o botão de merge
A entrada tem duas linhas: main: seguida dos commits da main, e branch: seguida dos commits da branch do PR (cada palavra é um commit). Imprima o histórico resultante da main para cada método de merge:
merge commit: A B X Y M
squash: A B S
rebase: A B X' Y'(M é o novo merge commit, S o novo commit de squash, e os commits com rebase ganham um ' porque são cópias novas.) Se a branch tiver só um commit, squash e rebase produzem esse único commit como uma cópia nova: S.
- Três commits
- Um commit
O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.
Rotule PRs por tamanho
Muitos projetos rodam um bot que rotula pull requests por tamanho. A entrada é um diff unificado. Conte as linhas adicionadas (que começam com +, mas não o cabeçalho de arquivo +++), as linhas removidas (que começam com -, mas não ---) e os arquivos alterados (linhas diff --git). Imprima files: 2, +7 -3 e uma label de tamanho a partir do total de linhas alteradas:
| Total | Label |
|---|---|
| menos de 10 | size/XS |
| menos de 50 | size/S |
| menos de 250 | size/M |
| menos de 1000 | size/L |
| caso contrário | size/XL |
- Uma pequena correção
- Nenhuma mudança
O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.
Dúvidas sobre esta lição
Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.
Carregando publicações…