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.

Usar Bate-papo do Copilot para entender a lógica

Você pode solicitar ajuda a Bate-papo do Copilot para entender a intenção do pull request ou para esclarecer qualquer parte da alteração.

1. No canto superior direito da página de solicitação de pull, clique no botão ao lado da barra de pesquisa.

             O Bate-papo do Copilot é exibido, com o pull request anexado como contexto à janela de prompt.
   

2. Na caixa de prompt, digite uma pergunta e pressione Enter. Por exemplo, você pode inserir:

   • What problem does this pull request solve?

   • Why were these changes needed?

   • Summarize the goals of this PR based on the linked issue.

   • How does this PR relate to issue ISSUE-URL?

          Bate-papo do Copilot pode ajudá-lo a esclarecer o quadro geral antes de mergulhar na análise linha por linha.
     

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. Opcionalmente, se você tiver acesso a GitHub Copilot Enterprise, poderá perguntar Copilot sobre as alterações em um arquivo em uma solicitação de pull clicando em no canto superior direito da página do arquivo, em seguida, clicando em Pedir Copilot sobre esta diferença e digitando uma solicitação como "Explique essas alterações." Para saber mais, confira Fazer perguntas ao GitHub Copilot no GitHub.

6. 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.

   

7. 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.

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

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

   

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

    

11. 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)

Noções básicas sobre alterações em uma pull request

          GitHub Copilot pode ajudá-lo a entender rapidamente as alterações em um pull request, fornecendo contexto e explicações para commits específicos. Se você não tiver certeza sobre o propósito de uma determinada alteração ou precisar de mais detalhes sobre como ela se encaixa na base de código mais ampla, você pode fazer perguntas ao Copilot sobre commits individuais.

1. Navegue até um commit no GitHub.

2. Na parte superior direita de qualquer página no GitHub, clique no ícone ao lado da barra de pesquisa.

   O painel do Copilot Chat do GitHub é exibido. Para redimensionar o painel, clique e arraste a borda superior ou esquerda.

3. Se o painel contiver uma conversa anterior que você teve com o Copilot, clique no ícone de sinal de adição no canto superior direito do painel do Copilot para iniciar uma nova conversa.

4. Na parte inferior do Copilot painel de chat, na caixa "Perguntar Copilot", digite uma pergunta e pressione Enter. Por exemplo, você pode inserir:

   • Summarize the changes in this commit

   • Who committed these changes?

   • When was this commit made?

   Dica

   Se você souber o SHA de um commit, em vez de navegar até o commit, você pode perguntar ao Copilot sobre o commit a partir de qualquer página do repositório no GitHub, incluindo o SHA na sua mensagem. Por exemplo, What changed in commit a778e0eab?

5. Opcionalmente, depois de enviar uma pergunta, você pode selecionar na caixa de texto para interromper a resposta.

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.