Revisar alterações proposta em pull requests

Em uma pull request, você pode revisar e comentar commits, arquivos alterados e diferenças (ou "diff") entre os arquivos nos branches base e de comparação.

Sobre revisões de pull requests

Você pode revisar as alterações em um arquivo de pull request por vez. Ao revisar os arquivos em um pull request, você pode deixar comentários individuais em alterações específicas. Após terminar de revisar cada arquivo, você pode marcar o arquivo como visualizado. Isso aninha o arquivo e ajuda a identificar os arquivos que ainda precisam ser revisadas. Uma barra de progresso no cabeçalho do pull request mostra o número de arquivos que você visualizou. Depois de revisar todos os arquivos você desejar, você pode aprovar a solicitação de pull ou solicitar alterações adicionais enviando a sua revisão com um comentário resumido.

Dica: É possível encontrar um pull request em que você ou uma equipe da qual você é membro é solicitado para revisão com o qualificador de pesquisa review-requested:[USERNAME] ou team-review-requested:[TEAMNAME]. Para obter mais informações, consulte "Pesquisa de problemas e pull requests".

Iniciar uma revisão

  1. Abaixo do nome do seu repositório, clique em Pull requests. Issues and pull requests tab selection
  2. Na lista de solicitações pull, clique na solicitação pull que você quer revisar.
  3. On the pull request, click Files changed.

Pull Request Files changed tab

  1. Passe o mouse sobre a linha de código onde você gostaria de adicionar um comentário e clique no ícone de comentário azul. Para adicionar um comentário em várias linhas clique e arraste para selecionar o intervalo de linhas e, em seguida, clique no ícone azul de comentário. Ícone de comentário azul
  2. No campo comentário, digite o seu comentário. Campo de comentário
  3. Opcionalmente, para sugerir uma alteração específica à linha ou linhas, clique em e, em seguida, edite o texto dentro do bloco de sugestão. Bloco de sugestão
  4. Quando terminar, clique em Start a review (Iniciar uma revisão). Se você já iniciou uma revisão, poderá clicar em Add review comment (Adicionar comentários à revisão). Botão Start a review (Iniciar uma revisão)

Antes de enviar a revisão, os comentários em linha ficam com status pendente e somente você pode visualizá-los. Você pode editar editar os comentários pendentes a qualquer momento antes de enviar a revisão. Para cancelar uma revisão pendente, incluindo todos os comentários pendentes, role para baixo até o final da linha do tempo na guia Conversation (Conversa) e clique em Cancel review (Cancelar revisão).

Botão Cancel review (Cancelar revisão)

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 obter mais informações, consulte "Revisar as mudanças de dependências em um pull request".

  1. On the pull request, click Files changed.

Pull Request Files changed tab

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

    Botão de diff avançado

  2. É 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 retornar à visão do diff de origem, clique no botão .

    Botão de diff de fonte

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. On the pull request, click Files changed.

Pull Request Files changed tab 2. À direta do cabeçalho do arquivo revisado, selecione Viewed (Visualizado). Caixa de seleção visualizado

Enviar a revisão

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

  1. On the pull request, click Files changed.

Pull Request Files changed tab

  1. Acima do código alterado, clique em Revisar alterações. Botão de revisar alterações
  2. Digite um comentário que resume o seu feedback sobre as alterações propostas. Janela de comentários para o resumo da revisão
  3. Selecione o tipo de revisão que você gostaria de deixar:Botões de opção com opções de revisão
    • Selecione Comment (Comentar) para incluir um feedback geral sem aprovar explicitamente as alterações nem solicitar alterações adicionais.
    • Selecione Approve (Aprovar) para enviar um feedback e aprovar o merge das alterações propostas na pull request.
    • Selecione Request changes (Solicitar alterações) para enviar um feedback que deve ser aplicado para que a pull request possa sofrer merge.
  4. Clique em Enviar revisão.

Dicas:

  • Se as revisões necessárias estiverem habilitadas e um colaborador com acesso de gravação, admin ou proprietário ao repositório enviar uma revisão solicitando alterações, o pull request não poderá ser mesclado até que o mesmo colaborador envie outra revisão aprovando as alterações no pull request.
  • Proprietários e administradores do repositório podem fazer merge de um pull request mesmo que não tenham recebido uma revisão de aprovação; ou se um revisor que solicitou alterações saiu da organização ou estiver indisponível.
  • Se as revisões necessárias e o descarte de uma revisão obsoleta estiverem habilitados e um commit de modificação de código for enviado para o branch de um pull request aprovado, a aprovação será ignorada. O pull request deve ser revisado e aprovado novamente antes de poder ser mesclado.
  • Quando vários pull requests abertos têm um branch principal que aponta para o mesmo commit, você não conseguirá mesclá-los se um ou ambos tiverem uma revisão pendente ou rejeitada.
  • Pull request authors cannot approve their own pull requests.

Leia mais

Esse documento ajudou você?Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.