Skip to main content

Sobre revisões de pull request

As revisões permitem que colaboradores comentem sobre as alterações propostas em pull requests, aprovem as alterações ou solicitem outras alterações antes do merge da pull request. Os administradores do repositório podem exigir que todas as pull requests sejam aprovadas antes de sofrerem o merge.

Sobre revisões de pull request

Depois que uma solicitação de pull for aberta, qualquer pessoa com acesso de leitura poderá revisar as alterações propostas e adicionar comentários a elas. Você também pode sugerir alterações específicas às linhas de código, que o autor pode aplicar diretamente a partir da pull request. Para obter mais informações, confira "Revisar alterações proposta em pull requests".

Por padrão, em repositórios públicos, qualquer usuário pode enviar análises que aprovem ou solicitem alterações em um pull request. Os proprietários da organização e os administradores de repositório podem limitar quem pode conceder revisões de solicitação de pull ou alterações de solicitação de aprovação. Para obter mais informações, confira "Gerenciando revisões de pull request na sua organização" e "Gerenciando avaliações de pull request no seu repositório."

Os proprietários de repositório e colaboradores podem solicitar uma revisão de pull request de uma pessoa específica. Os integrantes da organização também podem solicitar uma revisão de pull request de uma equipe com acesso de leitura ao repositório. Para obter mais informações, confira "Solicitar revisão de pull request". Você pode especificar um subconjunto de membros da equipe a ser atribuído automaticamente no lugar de toda a equipe. Para obter mais informações, confira "Gerenciando configurações de revisão de código para sua equipe".

As revisões permitem discussão das alterações propostas e ajudam a garantir que as alterações atendam às diretrizes de contribuição do repositório e outros padrões de qualidade. Você pode definir quais indivíduos ou equipes possuem determinados tipos de área de código em um arquivo CODEOWNERS. Quando uma pull request modifica código que tem um proprietário definido, esse indivíduo ou equipe será automaticamente solicitado como um revisor. Para obter mais informações, confira "Sobre os proprietários de código".

Para obter uma introdução à solicitação e ao fornecimento de revisões de solicitações pull, consulte o curso Revisar solicitações pull GitHub Skills.

Você pode agendar lembretes para solicitações de pull que precisam ser revisadas. Para obter mais informações, confira "Gerenciar lembretes agendados para a sua equipe".

Uma revisão tem três status possíveis:

  • Comentário: envie comentários gerais sem aprovar explicitamente as alterações nem solicitar alterações adicionais.
  • Aprovação: envie comentários e aprove a mesclagem das alterações propostas na solicitação de pull.
  • Solicitação de alterações: envie comentários que precisam ser resolvidos antes que a solicitação de pull possa ser mesclada.

Dicas:

  • Se um colaborador com acesso admin, owner ou write 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.

Você pode exibir todas as revisões que uma pull request recebeu na linha do tempo Conversation (Conversa), assim como pode ver revisões por proprietários e colaboradores de repositório na caixa de merge da pull request.

Captura de tela da caixa de mesclagem de uma solicitação de pull. Uma revisão feita pelo Octocat com alterações solicitadas está listada.

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 pull requests".

Resolver conversas

É possível resolver uma conversa em um pull request se você abriu o pull request ou se você tem acesso de gravação ao repositório em que o pull request foi aberto.

Para indicar que uma conversa na guia Arquivos alterados foi concluída, clique em Resolver conversa.

Toda a conversa será colapsada e marcada como resolvida, tornando mais fácil encontrar conversas que ainda precisam ser consideradas.

Se a sugestão em um comentário estiver fora do escopo do seu pull request, você pode abrir um novo problema que rastreia os comentários e relaciona o comentário original. Para obter mais informações, confira "Criar um problema".

Descobrindo e navegando por conversas

Você pode descobrir e procurar todas as conversas na sua solicitação de pull usando o menu Conversas, que é mostrado na parte superior da guia Arquivos Alterados.

Nesta visualização, você pode ver quais conversas não foram resolvidas, quais foram resolvidas e desatualizadas. Isso facilita a descoberta e a resolução de conversas.

Captura de tela do menu "Conversas" na guia "Arquivos Alterados" de uma solicitação de pull.

Ressolicitar uma revisão

Você pode ressolicitar uma revisão, por exemplo, após fazer alterações substanciais no seu pull request. Para solicitar uma nova revisão de um revisor, na barra lateral da guia Conversa, clique no ícone .

Revisões obrigatórias

Os administradores do repositório ou funções personalizadas com a permissão "editar regras do repositório" podem exigir que todas as solicitações de pull recebam um número específico de revisões de aprovação antes que alguém mescle a solicitação de pull em um branch protegido. Você pode exigir a aprovação de revisões de pessoas com permissões de gravação no repositório ou de um proprietário de código designado. Para obter mais informações, confira "Sobre branches protegidos".

Dica: se necessário, as pessoas com acesso de administrador ou de gravação em um repositório podem ignorar uma revisão de solicitação de pull. Para obter mais informações, confira "Ignorar uma revisão de pull request".

Leitura adicional