Compartilhar via

Revisar pull requests abertas no GitHub

  • Artigo

Este artigo explica como contribuir com o Microsoft Learn revisando pull requests (PRs) e adicionando comentários. Você pode ler novos tópicos e ver as atualizações propostas antes de serem publicadas verificando a fila de PRs abertas de um repositório público do GitHub. Os feedbacks da comunidade sobre atualizações propostas ajudam toda a comunidade.

Com comentários e avaliações de PRs, você pode:

  • adicionar e responder a comentários sobre a PR.
  • reagir a comentários com emojis, como , ❤️ e .

Pré-requisitos

Encontrar uma PR

  1. No browser da Web, navegue até o repositório GitHub que deseja revisar. Se você não tiver certeza de qual repositório examinar, encontre um que lhe interesse em nossa lista de repositórios do Microsoft Learn.

    Se você estiver navegando na documentação e não souber a qual repositório ela pertence, selecione o ícone de lápis Editar na parte superior da página. Essa ação leva você ao arquivo de origem no GitHub. O nome do repositório é exibido no canto superior esquerdo da página. Por exemplo, a imagem a seguir mostra o local do nome do repositório azure-dev-docs.

    Screenshot of a GitHub article page showing the repo name in the upper left-hand corner of the page.

  2. Escolha a guia Solicitações de pull para ver as PRs abertas desse repositório. Se o repositório tiver muitas PRs, use a barra Filtros para filtrar por rótulo, autor e mais. Ou use a barra Pesquisar para procurar consultas específicas.

    Screenshot of a GitHub repo showing the pull requests tab.

  3. Abra uma PR selecionando o link do título.

Revisar uma PR

  1. Na PR que você está revisando, selecione a guia Arquivos alterados.

    Screenshot of tabs on the GitHub pull request page. The tab titled Files Changed is highlighted.

  2. Compare o documento original com o editado. O documento original estará em vermelho e o documento proposto, em verde. Qualquer texto adicionado será realçado na seção verde (nova) e qualquer texto excluído será realçado na seção vermelha (original).

    Screenshot of a GitHub Files Changed page. An example of original content highlighted in red and edited content highlighted in green is displayed.

  3. Adicione comentários ou sugira alterações selecionando o ícone de adição (+) à esquerda da linha sobre a qual você deseja comentar. Para selecionar várias linhas, selecione e arraste o sinal de adição.

    Screenshot of a GitHub Files Changed page. The plus sign icon, intended for the user to select to enter in-line comments, is featured.

    Você só pode adicionar comentários ou sugestões às linhas que foram editadas na PR atual. Para fazer outras alterações, edite esse arquivo em sua própria PR.

  4. Uma caixa de diálogo será aberta. Digite seus comentários ou perguntas nela. Se desejar, você pode usar os botões na barra de ferramentas para formatar seu texto, adicionar listas numeradas e com marcadores ou inserir blocos de código e imagens.

    Screenshot of a GitHub Files Changed page. The comment box element is featured.

  5. Você também pode sugerir uma alteração no texto dessa linha.

    1. Na barra de ferramentas do comentário, selecione o ícone (provavelmente o ícone +- mais à esquerda). Este é o botão Inserir uma sugestão.

      Screenshot of tabs in a comment box on the GitHub Files Changed page. The tab with a + and - icon is highlighted.

    2. O texto da linha selecionada será incluído em um bloco de código (dentro de dois conjuntos de backticks ''').

      Screenshot of a comment box on the GitHub Files Changed page. An example of how to write the syntax for a suggestion is displayed.

      Para sugerir alterações no texto que inclui uma cerca de código com marcação tripla ('''), substitua os backticks externos/de fechamento suggestion por tis (~~~).

    3. Edite o texto. Use os botões na caixa de comentário para formatação simples, como negrito, itálico e marcadores, ou use os elementos de sintaxe Markdown diretamente. Você também pode adicionar comentários a essa caixa abaixo da seção de bloco de código.

  6. Depois de fazer seu comentário, selecione Iniciar uma revisão. O autor da PR será notificado sobre suas alterações. Se você usou o botão Inserir uma sugestão na etapa anterior, o autor poderá confirmar sua sugestão diretamente no documento.

    Se você quiser trazer outra pessoa para a conversa, poderá @mention outros contribuidores pelo alias do GitHub em seus comentários. Os usuários mencionados do GitHub receberão um email contendo seu comentário. Você também pode usar Markdown em seus comentários, e o Markdown do seu comentário será renderizado assim que você enviá-lo.

  7. Leia os comentários na guia Conversas. Se tiver perguntas ou comentários, adicione-os à conversa. Você também pode adicionar reações aos comentários selecionando o ícone de smiley no canto inferior esquerdo de cada comentário.

Enviar uma revisão

Depois de adicionar todos os seus comentários à revisão, envie a revisão.

  1. Selecione o botão Revisar alterações no canto superior direito da guia Arquivos alterados para abrir a caixa de diálogo de envio de revisão.
  2. Insira um Resumo de revisão descritivo.
  3. Selecione o botão de opção para o tipo de revisão desejado e escolha Enviar revisão.

Submitting a review in GitHub.

O autor da RP receberá a notificação da revisão.

Próximas etapas

Para saber mais sobre comentários e revisões, confira estes artigos na documentação do GitHub.