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 fazer comentários na guia Conversation (Conversa) de uma pull request para deixar comentários gerais, perguntas ou complementos. 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

Também é possível comentar em seções específicas de um arquivo na guia Files changed (Arquivos alterados) de uma pull request na forma de comentários em linha individuais ou como parte de uma revisão de pull request. 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 em linha a uma revisão de pull request, consulte "Revisar alterações propostas em uma pull request".

Observação: se você responder a uma pull request por e-mail, seu comentário será adicionado na guia Conversation (Conversa) e não fará parte de uma revisão de pull request.

Para responder a um comentário em linha existente, é preciso navegar até o comentário na guia Conversation (Conversa) ou Files changed (Arquivos alterados) e incluir um comentário em linha adicional abaixo dele.

Dicas:

  • Os comentários da pull request aceitam a mesma formatação como comentários regulares no GitHub, como @menções, emoji e referências.
  • Você pode adicionar reações aos comentários em pull requests na aba Arquivos alterados.

Adicionar comentários em linha a uma pull request

  1. Abaixo do nome do seu repositório, clique em Pull requests. Problemas e seleção da guia pull requests
  2. Na lista de pull requests, clique na pull request onde deseja deixar comentários em linha.
  3. No pedido de pull request, clique em Arquivos alterados. Guia Files changed (Arquivos alterados) da pull request
  4. 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, em seguida, clique no ícone azul do comentário. Ícone de comentário azul
  5. No campo comentário, digite o seu comentário. Campo de comentário
  6. Optionally, to suggest a specific change to the line or lines, click , then edit the text within the suggestion block. Suggestion block
  7. Quando tiver concluído, clique em >Add single comment (Adicionar único comentário). Janela de comentários inline

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 aba Arquivos alterados está completa, 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, consulte "Abrir um problema a partir de um comentário".

Descobrindo e navegando por conversas

Você pode descobrir e navegar até todas as conversas no seu pull request usando o menu Conversas que é exibido na parte superior da aba 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.

Mostrando o menu de conversas

Leia mais

Esse documento ajudou você?

Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.