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.

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.

Neste artigo

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 uma pull request, você pode deixar comentários individuais sobre alterações específicas. Quando terminar de revisar o arquivo, pode marcá-lo como visualizado. Isso aninha o arquivo e ajuda a identificar os arquivos que ainda precisam ser revisadas. Uma barra de progresso no header da pull request mostra o número de arquivos visualizados. Depois de revisar os arquivos desejados, você pode aprovar a pull request ou solicitar alterações adicionais enviando sua revisão com um comentário resumido.

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

Iniciar uma revisão

  1. Under your repository name, click Pull requests.

    Problemas e seleção da guia pull requests

  2. Na lista de solicitações pull, clique na solicitação pull que você quer revisar.

  3. On the pull request, click Files changed.

    Files Changed tab

  4. Hover over the line of code where you'd like to add a comment, and click the blue comment icon. To add a comment on multiple lines, click and drag to select the range of lines, then click the blue comment icon.

    Blue comment icon

    Note: Multiple-line comments are currently in public beta and subject to change.

  5. In the comment field, type your comment.

    Comment field

  6. Optionally, to suggest a specific change to the line, click , then edit the text within the suggestion block.

    Suggestion block

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

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.

    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.

    Files Changed tab

  2. Above the changed code, click Review changes.

    Review changes button

  3. Type a comment summarizing your feedback on the proposed changes.

    Review summary comment window

  4. Select the type of review you'd like to leave:

    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.
  5. Click Submit review.

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.

Leia mais

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato