Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

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.

Neste artigo:

Sobre revisões de pull request

Depois que uma pull request é aberta, qualquer pessoa com acesso de leitura pode revisar e comentar as alterações propostas. Você também pode sugerir alterações específicas em uma linha, que o autor pode aplicar diretamente da pull request. Para obter mais informações, consulte "Revisar alterações propostas em uma pull request".

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. For more information, see "Requesting a pull request review."

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, consulte "Sobre proprietários de código".

Header de revisão solicitando alterações com comentários em linha

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

  • Comment (Comentar): envie feedback genérico sem aprovar explicitamente as alterações nem solicitar alterações adicionais.
  • Approve (Aprovar): envie feedback e aprove o merge das alterações propostas na pull request.
  • Request changes (Solicitar alterações): envie feedback que deve ser cumprido para que a pull request possa sofrer merge.

Imagem de status de revisão

Dicas:

  • If required reviews are enabled and a collaborator with write, admin, or owner access to the repository submits a review requesting changes, the pull request cannot be merged until the same collaborator submits another review approving the changes in the pull request.
  • Repository owners and administrators can merge a pull request even if it hasn't received an approving review, or if a reviewer who requested changes has left the organization or is unavailable.
  • If both required reviews and stale review dismissal are enabled and a code-modifying commit is pushed to the branch of an approved pull request, the approval is dismissed. The pull request must be reviewed and approved again before it can be merged.
  • When several open pull requests each have a head branch pointing to the same commit, you won’t be able to merge them if one or both have a pending or rejected review.

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.

Imagem de revisões em uma caixa de merge

Tip: You can find a pull request where you or a team you're a member of is requested for review with the search qualifier review-requested:[USERNAME] or team-review-requested:[TEAMNAME]. For more information, see "Searching issues and pull requests."

Resolver conversas

You can resolve a conversation in a pull request if you opened the pull request or if you have write access to the repository where the pull request was opened.

To indicate that a conversation on the Files changed tab is complete, click Resolve conversation.

Pull request conversation with Resolve conversation button

The entire conversation will be collapsed and marked as resolved, making it easier to find conversations that still need to be addressed.

Resolved conversation

If the suggestion in a comment is out of your pull request's scope, you can open a new issue that tracks the feedback and links back to the original comment. Para obter mais informações, consulte "Incluir feedback na pull request".

Revisões obrigatórias

Repository administrators can require that all pull requests receive a specific number of approving reviews from people with write or admin permissions in the repository or from a designated code owner before they're merged into a protected branch. Para obter mais informações, consulte "Sobre branches protegidos".

When required reviews are enabled, anyone with access to the repository can approve changes in a pull request. However, you won't be able to merge your pull request until the required number of reviewers with write or admin permissions in the repository approve your pull request's changes in their review. For more information about repository permission levels, see "Repository permission levels for an organization." If review is required from a designated code owner and the pull request affects code that has a designated owner, approval from that owner is required.

Para obter mais informações, consulte "Sobre revisões obrigatórias para pull requests".

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

Leia mais

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato