git | Pull Request

Pull Request

Missão cumprida! Criamos nossa branch, fizemos os ajustes e atualizações necessárias... mas... e agora? Como trazer nossas atualizações para o projeto/repositório de origem?

Como trazer nossos updates para a branch principal do projeto?

Já vimos que o git push sobe nossas atualizações para o repositório remoto. Mas se você criou tudo numa branch difefente (que é a maneira correta), como proceder?

Ao realizar o push de uma branch nova, você se deparará com uma mensagem sugerindo que acesse um link para abrir um Pull Request. Não se preocupe, está tudo certo! Esse Pull Request (PR), permitirá que seus colegas revisem o código (Code Review) e aprovem seu PR para, depois, mergear sua nova branch com a master (ou develop ou branch de trabalho) - o merge está descrito na próxima lição. Mas antes...

Acesse o link sugerido ou acesse seu repositório remoto (no github.com) e abra seu PR.

Ao abrir sua PR, o primeiro passo é definir qual branch receberá sua branch finalizada. Normalmente nós mergeamos uma branch nova com a branch de desenvolvimento ou homologação - mas isso depende do git flow (ou fluxo de trabalho no git) que estamos utilizando. Esse ponto é muito importante, pois se direcionar seu PR para a branch errada pode dar muita dor de cabeça.

Em seguida nomeamos o PR (normalmente virá com o nome do último commit) e descrevemos a task/branch. É uma boa prática mencionar qual o cenário em que sua feature/recurso/novidade é aplicada, como o dev que fará o code review deve navegar e testar. Quanto mais explicativa, clara e objetiva for sua descrição, melhor!

Depois você ainda pode adicionar reviewers sugeridos (quem você quer que revise seu código), indicar o responsável pela PR (provavelmente você), adicionar labels (rótulos) e outros detalhes.

Por fim, você abre o PR e aguarda alguém aprová-lo (o reviewer ou revisor deverá ver tanto a funcionalidade quanto o código).

Uma vez aprovado o PR, podemos 'mergeá-lo' - veja na lição seguinte como fazer o merge.