Revisar alterações propostas em um pull request

Entendendo a finalidade de uma solicitação de solicitação de pull

Obter uma compreensão clara da motivação por trás de uma solicitação de pull ajuda a informar sua revisão, para que você possa mantê-la direcionada e significativa e fornecer comentários alinhados com a intenção do autor da solicitação de pull e as metas do projeto.

Há várias opções disponíveis para entender melhor o contexto e a lógica das alterações propostas.

Usando a barra lateral de solicitações de pull para contexto

Na barra lateral da solicitação de pull, você pode encontrar um contexto valioso, incluindo:

• Problemas ou discussões vinculadas: revise-os para entender os problemas ou metas que o pull request pretende resolver ou para obter informações sobre, por exemplo, plano de fundo, decisões de design ou debates atuais.
• Projetos ou marcos vinculados: examine como essa solicitação de pull se encaixa em projetos maiores ou versões futuras.

Use essas informações para enquadrar sua revisão e verificar se as metas da solicitação de pull estão alinhadas com a intenção original.

Iniciar uma revisão

1. Abaixo do nome do repositório, clique em Pull requests.

   

2. Na lista de solicitações pull, clique na solicitação pull que você quer revisar.

3. Na pull request, clique em Files changed.

   
   Você pode alterar o formato da visualização do diff clicando em nesta guia e escolhendo a visualização unificada ou dividida. A escolha que você fizer será aplicada quando você visualizar o diff para outros pull requests.
   

   Você também pode optar por ocultar as diferenças nos espaços em branco. A escolha que você fizer só se aplica a este pull request e será lembrada na próxima vez que você acessar esta página.

4. Opcionalmente, filtre os arquivos para mostrar apenas os arquivos que deseja revisar ou usar a árvore de arquivos para acessar um arquivo específico. Para saber mais, confira Filtrar arquivos em uma pull request.

5. Passe o mouse sobre a linha de código em que você gostaria de adicionar um comentário e clique no ícone de comentário azul.

   

6. Como alternativa, adicione um comentário em várias linhas. Para selecionar um intervalo de linhas, clique no número de linha da primeira linha em que você deseja comentar, arraste para baixo até a linha final ou mantenha pressionada a tecla Shift e clique no último número de linha. Em seguida, você pode clicar no ícone de comentário azul na última linha na qual deseja comentar. Como opção, você pode clicar no ícone de comentário azul ao lado da primeira linha que deseja comentar e, em seguida, arrastar para baixo até a última linha que deseja comentar.

7. No campo comentário, digite o seu comentário.

8. Opcionalmente, para sugerir uma alteração específica nas linhas, clique em e editr o texto no bloco de sugestão.

   

9. Para comentar diretamente em um arquivo, à direita do arquivo, clique em e digite seu comentário.

   

10. Quando terminar, clique em Iniciar uma revisão. Se você já tiver iniciado uma revisão, clique em Adicionar comentário sobre a revisão.

Antes de enviar a revisão, os comentários em linha ficam com o status pendente e somente você pode visualizá-los. Você pode editar os comentários pendentes a qualquer momento antes de submeter a revisão. Para cancelar uma revisão pendente, incluindo todos os comentários pendentes, clique em Revisar alterações acima do código alterado e em Abandonar revisão.

          ![Captura de tela do campo de comentário de uma revisão. O botão "Abandonar revisão" é descrito em laranja escuro.](/assets/images/help/pull_requests/abandon-review-button.png)

Revisar alterações de dependência

Se o pull request contiver alterações em dependências, você poderá usar a revisão de dependências para um manifesto ou arquivo de bloqueio para ver o que mudou e verificar se as alterações introduzem vulnerabilidades de segurança. Para saber mais, confira Revisão de alterações de dependências em um pull request.

1. Na pull request, clique em Files changed.

   

2. À direita do cabeçalho de um arquivo de manifesto ou de bloqueio, exiba a revisão de dependências clicando no botão de diff avançado .

   

3. É possível que você também queira revisar o diff da fonte, porque pode haver alterações no manifesto ou arquivo de bloqueio que não mudam as dependências, ou pode haver dependências que GitHub não pode analisar e que, consequentemente, não aparecem na revisão de dependências.

   Para voltar à exibição de comparação de origem, clique no botão .

   

Marcar um arquivo como visualizado

Quando terminar de revisar um arquivo, você pode marcar o arquivo como visualizado, e o arquivo será aninhado. Se o arquivo for alterado após ser visualizado, será desmarcado como visualizado.

1. Na pull request, clique em Files changed.

   

2. À direta do cabeçalho do arquivo que você terminou de revisar, selecione Visualizado.

   

Enviar a revisão

Quando terminar de revisar os arquivos que deseja incluir na pull request, envie a revisão.

1. Na pull request, clique em Files changed.

   

2. Acima do código alterado, clique em Revisar alterações.

   

3. Digite um comentário que resume o seu feedback sobre as alterações propostas.

4. Selecione o tipo de revisão que você gostaria de deixar:

   • Selecione Comentar para incluir um comentário geral sem aprovar explicitamente as alterações nem solicitar alterações adicionais.
   • Selecione Aprovar para enviar seu comentário e aprovar a mesclagem das alterações propostas na solicitação de pull.
   • Selecione Solicitar alterações para enviar comentários que precisam ser resolvidos para que a solicitação de pull seja mesclada.

5. Clique em Enviar revisão.