Partilhar via

Revisar solicitações pull abertas no GitHub

  • Artigo

Este artigo explica como contribuir para o Microsoft Learn revisando solicitações pull (PRs) e adicionando seus comentários. Você pode ler novos tópicos e ver as atualizações propostas antes de serem publicadas, verificando a fila de RP aberta de um repositório público do GitHub. O feedback da comunidade sobre as atualizações propostas ajuda toda a comunidade.

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

  • Adicione e responda aos comentários sobre o PR.
  • Reaja a comentários com emojis como 👍, ❤️ e 🎉 .

Pré-requisitos

Encontre um PR

  1. Em seu navegador, navegue até o repositório no GitHub que você 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 ele pertence, selecione o ícone Editar lápis na parte superior da página. Esta 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 para o azure-dev-docs repositório.

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

  2. Escolha a guia Pull requests para ver os PRs abertos para esse repositório. Se o repositório tiver muitos PRs, use a barra Filtros para filtrar por rótulo, autor e muito mais. Ou use a barra de pesquisa para procurar consultas específicas.

    Screenshot of a GitHub repo showing the pull requests tab.

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

Rever um RP

  1. Na RP que está a rever, selecione o separador Ficheiros 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 será em vermelho e o documento proposto em verde. Qualquer texto adicionado será realçado na secção verde (novo) e qualquer texto eliminado será realçado na secçã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 mais (+) à esquerda da linha sobre a qual 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 a linhas que foram editadas na RP atual. Para fazer outras alterações, edite esse arquivo em seu próprio PR.

  4. Abre-se uma caixa. Introduza aí os seus comentários ou perguntas. Se desejar, você pode usar os botões na barra de ferramentas para formatar o 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 nessa 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 que você selecionou 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 inclua uma cerca de código tripla ('''), substitua os backticks externos/fechados suggestion por tils (~~~).

    3. Edite o texto. Use os botões na caixa de comentários 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 esta caixa abaixo da seção de bloco de código.

  6. Depois de fazer o comentário, selecione Iniciar uma avaliação. O autor do RP será notificado das 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, você pode @mention outros colaboradores pelo alias do GitHub em seus comentários. Os usuários do GitHub mencionados receberão um e-mail contendo seu comentário. Você também pode usar Markdown em seus comentários, e o Markdown do seu comentário é renderizado assim que você envia o comentário.

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

Enviar uma avaliação

Depois de adicionar todos os comentários à avaliação, envie-a.

  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 descritivo da revisão.
  3. Selecione o botão de opção para o tipo de avaliação desejado e, em seguida, escolha Enviar avaliação.

Submitting a review in GitHub.

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

Próximos passos

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