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 mesclar as alterações, pois o proprietário pode abandonar a solicitação pull a qualquer momento.
Revise seu código
A revisão de código feita em uma solicitação pull não é apenas para encontrar bugs — é isso que seus testes estão preocupando.
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 ótimo feedback em uma solicitação pull 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 pode fornecer uma descrição clara de suas alterações e criar seu código que tem sua correção ou recurso 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.
Esse feedback tem uma intenção clara e é fácil de entender para o proprietário da solicitação pull.
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 recursos separados da solicitação pull 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 é obrigado a melhorar a qualidade e a confiabilidade das alterações de código.
Além disso, considere implementar a política Verificar 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.