Uma solicitação de pull propõe a mesclagem de alterações de código de um branch para outro. Como um recurso colaborativo, as solicitações de pull oferecem um lugar para discutir e revisar o trabalho antes que ele se torne parte de um projeto.
Por que usar solicitações de pull
Solicitações pull transformam um conjunto de alterações de código em uma conversa. Em vez de integrar diretamente o trabalho, você o propõe para que os colaboradores possam dar sua opinião. Isso ajuda você e sua equipe a manter código seguro e de alta qualidade, de algumas maneiras:
- Detecte bugs e problemas cedo, antes que eles cheguem ao ramo principal.
- Discuta e melhore as alterações em conjunto, com comentários vinculados a linhas específicas.
- Mantenha um histórico claro e revisível do que mudou e por quê.
O que você pode fazer com pull requests
As solicitações de pull facilitam a revisão e a validação de suas alterações. Com uma solicitação de pull, você pode:
- Propor alterações a partir de uma branch ou de um fork.
- Discutir e revisar as alterações propostas, linha por linha.
- Execute verificações automatizadas, como testes, builds e verificação de código, em relação às alterações.
- Responda aos comentários e atualize a solicitação de pull conforme ela evolui.
- Mesclar as alterações depois de concluídas as revisões e as verificações necessárias.
Partes principais de uma solicitação de pull
Uma solicitação de pull reúne tudo o que você e seus revisores precisam em um só lugar:
- A conversa mostra a descrição, os comentários, as revisões e uma linha do tempo da atividade.
- Commits mostram como a ramificação mudou ao longo do tempo.
- As verificações mostram os resultados de testes automatizados, builds e outras validações.
- Os arquivos alterados mostram a diferença na qual os revisores comentam.
- A caixa de mesclagem resume se você pode mesclar suas alterações ou não. Mostra o que talvez ainda precise ser feito, como revisões ou verificações obrigatórias, antes que um pull request possa ser mesclado.
Como as solicitações de pull se ajustam ao fluxo de trabalho
Se você estiver propondo alterações ou revisando as de outra pessoa, uma solicitação de pull segue alguns estágios:
- Ramificar ou bifurcar o repositório para criar um local isolado para funcionar.
- Confirme suas alterações conforme o uso, criando um histórico do seu trabalho.
- Abra uma solicitação de pull para propor a mesclagem de suas alterações no branch base.
- Examine e discuta as alterações com os colaboradores, fazendo atualizações conforme necessário.
- Mesclar o pull request quando estiver pronto.