Depois que você abre uma pull request, os revisores fazem comentários que ajudam a melhorar seu código antes que ela seja mesclada. Resolver esse comentário significa entender cada comentário, fazer as alterações que ele exige e garantir que você tenha resolvido tudo.
Noções básicas sobre comentários de revisão
Os revisores podem deixar comentários gerais, comentar linhas específicas e propor alterações exatas como sugestões. As revisões aparecem na linha do tempo da solicitação de pull para que você possa acompanhar a discussão e ver quais comentários ainda precisam de uma resposta. Dependendo das configurações do repositório, um revisor também pode aprovar sua solicitação de pull ou solicitar alterações que você deve resolver antes da mesclagem.
Antes de alterar qualquer coisa, leia cada comentário para entender sua intenção. Um comentário pode apontar um bug, fazer uma pergunta, solicitar uma abordagem diferente ou sugerir uma edição que você possa aceitar diretamente.
Se você tiver acesso a Copilot, ele poderá ajudá-lo a interpretar os comentários da revisão e sugerir correções, o que é útil quando um pull request tem muitos comentários para analisar.
Implementando alterações e corrigindo código
Ao endereçar comentários, você pode:
- Aplique diretamente a alteração sugerida por um revisor, o que confirma a sugestão em sua ramificação.
- Faça edições mais abrangentes localmente e envie novos commits para a ramificação.
A maioria dos feedbacks é resolvida atualizando seu código e enviando novos commits para a ramificação da pull request request. À medida que você aborda comentários, marque conversas como resolvidas para que você e seus revisores possam acompanhar o que é feito e o que ainda precisa de atenção.
Quando os revisores obrigatórios tiverem aprovado e não houver mais alterações solicitadas, seu pull request estará pronto para seguir para mesclagem. Como a solicitação de pull rastreia o branch, cada nova confirmação atualiza a solicitação de pull e executa novamente as verificações automatizadas.
Lidando com o feedback de forma eficiente
Em pull requests maiores ou mais analisadas, algumas práticas ajudam você a responder ao feedback rapidamente:
-
**Aceitar sugestões em lote** adicionando as alterações sugeridas a um lote para que várias alterações aceitas sejam incluídas em um único commit, em vez de um commit por sugestão. - Resolva quaisquer conflitos de mesclagem com antecedência, assim você poderá mesclar rapidamente assim que a revisão do seu pull request for concluída.
- Solicite revisões novamente depois de fazer alterações substanciais, para que os revisores saibam que o pull request está pronto para uma nova análise.
- Entenda as revisões necessárias. Quando uma ramificação requer aprovações ou a assinatura do proprietário do código, uma revisão de "solicitar alterações" ou uma aprovação rejeitada pode bloquear a mesclagem até que seja resolvida.
-
**Acompanhe o feedback fora do escopo** abrindo um problema que faça referência ao comentário, em vez de expandir a pull request.
Ferramentas para ajudá-lo a resolver revisões
Você não precisa analisar o feedback manualmente, sozinho:
- Confira o pull request localmente ou abra-o em GitHub Codespaces para reproduzir os problemas e testar as correções antes de fazer push.
- Resolva as descobertas de segurança geradas durante a revisão. Os alertas de verificação de código em suas alterações aparecem na solicitação de pull para que você possa corrigi-los antes de mesclar.