Skip to main content

Revisar alterações proposta em pull requests

Em uma solicitação de pull, você pode examinar e discutir commits, arquivos alterados e as diferenças (ou "comparação") 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: encontre uma solicitação de pull na qual você ou uma equipe da qual você é membro é solicitada para revisão com o qualificador de pesquisa review-requested:[USERNAME] ou team-review-requested:[TEAMNAME]. Para obter mais informações, confira "Pesquisar problemas e solicitações de pull".

Iniciar uma revisão

  1. Abaixo do nome do repositório, clique em Solicitações de pull. Seleção da guia Solicitações de pull 1. Na lista de solicitações pull, clique na solicitação pull que você quer revisar. 1. Na solicitação de pull, clique em Arquivos alterados. Guia Arquivos alterados da solicitação de pull

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

    Configurações de exibição do diff

    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.

  2. Opcionalmente, filtre os arquivos para mostrar apenas aqueles que deseja examinar. Para obter mais informações, confira "Como filtrar arquivos em uma solicitação de pull".

  3. 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. Para adicionar um comentário em várias linhas, clique e arraste para selecionar o intervalo de linhas e clique no ícone de comentário azul. Ícone de comentário azul 1. No campo comentário, digite o seu comentário. Campo de comentário 1. Há a opção de sugerir uma alteração específica na(s) linha(s) clicando em e, em seguida, editando o texto no bloco de sugestão. Bloco de sugestão

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

    Botão Start a review (Iniciar uma 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 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 a página para baixo até o final da linha do tempo na guia Conversa e clique em Cancelar revisão.

Botão 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, confira "Como revisar as alterações de dependência em uma solicitação de pull".

  1. Na solicitação de pull, clique em Arquivos alterados. Guia Arquivos alterados da solicitação de pull

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

    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 retornar ao modo de exibição de diferenciação 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. Na solicitação de pull, clique em Arquivos alterados. Guia Arquivos alterados da solicitação de pull

  2. À direta do cabeçalho do arquivo que você terminou de revisar, selecione 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. Na solicitação de pull, clique em Arquivos alterados. Guia Arquivos alterados da solicitação de pull 1. Acima do código alterado, clique em Revisar alterações. Botão Revisar alterações 1. Digite um comentário que resume o seu feedback sobre as alterações propostas. Janela do comentário sobre o resumo da revisão

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

    Botões de opção com opções de revisão

    • 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.
  3. Clique em Enviar revisão.

Dicas:

  • Se as revisões necessárias estiverem habilitadas e um colaborador com acesso de gravação, administrador ou proprietário no repositório enviar uma revisão solicitando alterações, a solicitação de pull não poderá ser mesclada até que o mesmo colaborador envie outra revisão aprovando as alterações na solicitação de pull.
  • 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.
  • Se o repositório exigir a aprovação de revisões de pessoas com permissões de gravação ou de administrador, todas as aprovações de pessoas com essas permissões serão indicadas com uma marca de seleção verde e as aprovações de pessoas sem essas permissões têm uma marca de seleção cinza. As aprovações com uma marca de seleção cinza não afetam a possibilidade de mesclagem da solicitação de pull.
  • Os autores de pull request não podem aprovar seus próprios pull requests.

Leitura adicional