Skip to main content

Fazer comentários em uma pull request

Depois de abrir uma pull request em um repositório, os colaboradores ou integrantes da equipe podem comentar na comparação dos arquivos entre os dois branches especificados ou deixar os comentários gerais no projeto como um todo.

Sobre comentários da pull request

Você pode adicionar um comentário na guia Conversa de uma solicitação de pull para deixar comentários gerais, perguntas ou objetos. Você também pode sugerir alterações que o autor da pull request pode aplicar diretamente a partir do seu comentário.

Conversa da pull request

Você também pode adicionar um comentário a seções específicas de um arquivo na guia Arquivos alterados de uma solicitação de pull na forma de comentários de linha individuais ou como parte de uma revisão de solicitação de pull. Adicionar comentários em linha é uma excelente maneira de discutir questões sobre implementação ou fornecer feedback ao autor.

Para obter mais informações sobre como adicionar comentários de linha a uma revisão de solicitação de pull, confira "Como revisar as alterações propostas em uma solicitação de pull".

Observação: se você responder a uma solicitação de pull por email, seu comentário será adicionado na guia Conversa e não fará parte de uma revisão de solicitação de pull.

Para responder a um comentário de linha existente, você precisará procurar o comentário na guia Conversa ou Arquivos alterados e adicionar um comentário de linha abaixo dele.

Dicas:

  • Os comentários de solicitação de pull dão suporte à mesma formatação que os comentários comuns do GitHub, como @mentions, emojis e referências.
  • Você pode adicionar reações aos comentários em solicitações de pull na guia Arquivos alterados.

Adicionar comentários em linha a uma pull request

  1. Abaixo do nome do repositório, clique em Solicitações de pull. Seleção da guia Problemas e solicitações de pull
  2. Na lista de pull requests, clique na pull request onde deseja deixar comentários em linha.
  3. On the pull request, click Files changed. Pull Request Files changed tab 1. 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. Optionally, to suggest a specific change to the line or lines, click , then edit the text within the suggestion block. Suggestion block
  4. Quando terminar, clique em Adicionar comentário individual. Janela de comentários em linha

Qualquer pessoa que inspeciona a pull request ou o repositório receberá uma notificação de seu comentário.

Resolving conversations

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. For more information, see "Opening an issue from a comment."

Discovering and navigating conversations

You can discover and navigate to all the conversations in your pull request using the Conversations menu that's shown at the top of the Files Changed tab.

From this view, you can see which conversations are unresolved, resolved, and outdated. This makes it easy to discover and resolve conversations.

Showing the conversations menu

Leitura adicional