Um pull request propõe a fusão de alterações de código de uma ramificação em outra. 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 precocemente, antes que cheguem à ramificação 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:
- Proponha alterações a partir de uma ramificação ou 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.
-
**Arquivos alterados** mostra as diferenças que 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:
-
**Crie uma ramificação ou fork** do repositório para criar um ambiente de trabalho isolado. -
**Faça commits** das suas alterações à medida que as desenvolve, construindo 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.
-
**Faça merge** do pull request quando estiver pronto.