Colabore com solicitações pull
As solicitações pull permitem que você informe outras pessoas sobre as alterações enviadas por push para um repositório do GitHub.
Uma vez que uma solicitação pull é enviada, as partes interessadas podem revisar o conjunto de alterações, discutir possíveis modificações e até mesmo enviar commits de acompanhamento, se necessário.
As solicitações pull são comumente usadas por equipes e organizações que colaboram usando o Modelo de Repositório Compartilhado.
Todos compartilham um único repositório e ramificações de tópicos são usadas para desenvolver recursos e isolar alterações.
Muitos projetos de código aberto no GitHub usam solicitações pull para gerenciar alterações de contribuidores.
Eles ajudam a fornecer uma maneira de notificar os mantenedores do projeto sobre as alterações feitas.
Além disso, inicie a revisão de código e a discussão geral sobre um conjunto de alterações antes de ser mesclado na ramificação principal.
As solicitações pull combinam a revisão e a mesclagem do seu código em um único processo colaborativo.
Quando terminar de corrigir um bug ou um novo recurso em uma ramificação, crie uma nova solicitação pull.
Adicione os membros da equipe à solicitação pull para que eles possam revisar e votar em suas alterações.
Use solicitações pull para revisar trabalhos em andamento e obter feedback antecipado sobre as alterações.
Não há compromisso de fundir as alterações, pois o proprietário pode abandonar o pull request a qualquer momento.
Revise seu código
A revisão de código feita em um pull request não é apenas para encontrar bugs — é para isso que os seus testes se destinam.
Uma boa revisão de código deteta problemas menos óbvios que podem levar a problemas dispendiosos mais tarde.
As revisões de código ajudam a proteger sua equipe contra mesclagens incorretas e compilações quebradas que prejudicam a produtividade da sua equipe.
A revisão deteta esses problemas antes da mesclagem, protegendo suas ramificações essenciais contra alterações indesejadas.
Polinize a experiência e espalhe estratégias de resolução de problemas usando uma ampla gama de revisores em suas revisões de código.
A difusão de competências e conhecimentos torna a sua equipa mais robusta e resiliente.
Dê um ótimo feedback
As avaliações de alta qualidade começam com feedback de alta qualidade. As chaves para um óptimo feedback num pull request são:
- Peça às pessoas certas que analisem o pull request.
- Certifique-se de que os revisores saibam o que o código faz.
- Dê feedback prático e construtivo.
- Responda aos comentários prontamente.
Ao atribuir revisores à sua solicitação pull, certifique-se de selecionar o conjunto certo de revisores.
Você quer revisores que saibam como seu código funciona e tente incluir desenvolvedores que trabalham em outras áreas para compartilhar suas ideias.
Além disso, quem é capaz de fornecer uma descrição clara das suas alterações e criar o código que inclui a sua correção ou funcionalidade em execução.
Os revisores devem tentar fornecer feedback sobre as alterações das quais discordam. Identifique o problema e dê uma sugestão específica sobre o que faria de diferente.
Este feedback tem uma intenção clara e é fácil de entender para o autor do pull request.
O proprietário da solicitação pull deve responder aos comentários, aceitar a sugestão ou explicar por que a alteração sugerida não é a ideal.
Às vezes, uma sugestão é boa, mas as alterações estão fora do escopo do pull request.
Pegue essas sugestões e crie novos itens de trabalho e ramificações de funcionalidades, separados do pull request, para fazer essas alterações.
Proteja as filiais com políticas
Seus repositórios normalmente contêm uma ou mais ramificações, incluindo a principal, que exigem proteção extra devido à sua criticidade. O Azure Repos oferece vários mecanismos baseados em políticas que você deve considerar implementar para ajudá-lo a atingir essa meta.
A premissa básica desses mecanismos é aplicar restrições para receber solicitações. Por exemplo, você pode incluir a imposição de políticas específicas de revisão de código, como exigir um número mínimo de aprovações de revisores designados antes que uma solicitação pull possa ser mesclada. Aproveitar a experiência coletiva irá melhorar a qualidade e a confiabilidade das alterações de código.
Além disso, considere implementar a política de verificação dos itens de trabalho vinculados. Isso verifica se cada solicitação pull está vinculada a um item de trabalho, fornecendo contexto e promovendo a rastreabilidade. A política Verificar se há resolução de comentários ajuda a garantir que todos os comentários de revisão de código sejam abordados antes de mesclar a solicitação pull.
As políticas relacionadas à análise automatizada de código, testes e verificações de conformidade confirmam que as alterações atendem aos padrões predefinidos antes da integração. Limitar os tipos de mesclagem ajuda a manter o histórico de ramificações de controle. Por exemplo, você tem a opção de permitir apenas fusões de avanço rápido e squash.
Também é possível exigir compilações limpas de novas versões de código antes de permitir que elas sejam mescladas nas ramificações críticas. Isso garantirá que as alterações mescladas não introduzam falhas de compilação ou problemas de regressão. As verificações de status podem ser usadas para condicionar a conclusão de solicitações pull a sinais gerados por serviços externos. Por exemplo, esses sinais podem ser gerados por Pipelines do Azure executando testes automatizados e análise de código.
Todas as ramificações que tenham políticas necessárias configuradas bloqueiam automaticamente o envio direto, impondo efetivamente solicitações pull para todas as alterações. Além disso, essas sucursais não podem ser suprimidas.