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 Enterprise Server, 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 Solicitações de pull
  2. Na lista de pull requests, clique na pull request onde deseja deixar comentários em linha.
  3. Na solicitação de pull, clique em Arquivos alterados. Guia Arquivos alterados da solicitação de pull 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. 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 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.

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.

Conversa de pull request com o botão de Resolver conversa

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

Conversa resolvida

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 "Como abrir um problema por meio de um comentário".

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.

Como exibir o menu Conversas

Leitura adicional