As revisões de pull request são a forma como as equipes identificam problemas cedo e mantêm a qualidade do código em alto nível. Este guia de início rápido explica cada uma das principais ferramentas para uma revisão:
- Comentar sobre o código
- Sugerir edições específicas
- Enviar sua revisão e aprovar ou solicitar alterações
Comentar sobre as alterações
Qualquer pessoa com acesso de leitura a um repositório pode revisar e comentar um pull request.
- Em GitHub, navegue até a pull request.
- Leia o resumo da solicitação de pull e quaisquer comentários ou problemas relevantes para criar contexto para revisão.
- Clique na guia Arquivos alterados .
- Passe o mouse sobre a linha na qual você deseja comentar e clique em . Para comentar em várias linhas, clique e arraste para selecioná-las.
- Digite seu comentário e clique em Iniciar uma revisão para salvá-lo como pendente até concluir a revisão. Os comentários pendentes só ficam visíveis para você até que você envie a revisão.
Fazer sugestões de código
Quando você souber a alteração exata desejada, sugira-a para que o autor possa aplicá-la em um clique.
- Na guia Arquivos alterados , inicie um comentário na linha ou linhas que você deseja alterar.
- Na barra de ferramentas de comentário, clique para inserir um bloco de sugestões e edite o código dentro dele para mostrar a alteração proposta.
- Clique em Iniciar uma revisão ou Adicionar comentário de revisão para incluir a sugestão em sua revisão.
Enviar sua revisão
Conclua enviando sua revisão com uma decisão que informa ao autor o que fazer a seguir.
-
Clique em Revisar alterações.
-
Adicione um comentário resumido.
-
Selecione uma decisão e clique em Enviar revisão:
- O comentário deixa comentários sem aprovar ou solicitar alterações explicitamente.
- Aprovar indica que as alterações estão prontas para mesclar.
- Solicitar alterações sinaliza comentários que o autor deve abordar antes da mesclagem.