Pull request

Definição

Pull request é uma proposta de incorporar mudanças de uma branch em outra. Ele existe na plataforma de hospedagem e reúne a origem, o destino, a descrição da proposta e o diff das alterações. É um espaço de colaboração, onde revisores comentam, pedem ajustes e acompanham as verificações automáticas.

O que compõe a proposta

Um pull request parte de uma branch de origem e aponta para uma branch de destino. A descrição explica o que muda e por quê. A aba de arquivos alterados mostra o diff, e a discussão registra comentários e respostas. As verificações automáticas indicam se os testes e outras checagens passaram.

Abrir não integra

Abrir um pull request não integra as mudanças. Ele apenas coloca a proposta em revisão. A integração acontece depois, quando a proposta é aceita e o merge é executado. Enquanto isso, a branch de destino permanece como estava.

A revisão que não acontece

No exemplo do novo campo, a proposta é revisada antes da integração. A falha provável acontece quando o pull request é aprovado sem leitura do diff, com as verificações automáticas falhando ou com a descrição divergindo das alterações reais. A revisão funciona quando cada parte confere o que mudou, compara com o que foi descrito e espera as checagens passarem antes do merge. Abrir a proposta sem revisar não é um atalho: é o ponto onde defeitos passam sem serem notados.

Aplicação na formação

Developer Workspace

Na Formação Developer Workspace, o pull request reúne a mudança proposta, a revisão e as verificações antes da integração à linha principal.

Conhecer a formação →