Skip to main content

Revisando suas alterações propostas

Revise seu próprio pull request antes de mesclar para identificar bugs e melhorar a qualidade, com assistência opcional de IA do Copilot.

Um pull request é uma chance de revisar seu trabalho com um novo olhar antes de se tornar parte de main. Neste tutorial, você examinará suas próprias alterações, aplicará melhorias e mesclará o primeiro recurso para seu site.

Pré-requisitos

Por que revisar o código?

Revisar as alterações antes de mesclar ajuda a identificar bugs, perceber a falta de tratamento de erros e melhorar a legibilidade enquanto o trabalho ainda está fresco na memória. Mesmo quando você trabalha sozinho, uma revisão deliberada cria um hábito que mantém seus projetos de software íntegros e facilita a colaboração mais tarde.

Revisando suas alterações no pull request

A aba Arquivos alterados em um pull request no GitHub mostra as diferenças de tudo o que sua ramificação adiciona ou modifica. Revise-o com cuidado.

  1. Clique em Ver suas pull requests para ir para a caixa de entrada das suas pull requests em GitHub. Como alternativa, navegue até seu repositório stargazers-log e clique na guia Pull requests.
  2. Clique no título para abrir seu pull request da ramificação add-starred-list.
  3. Clique na guia Arquivos alterados .
  4. Leia o diff de cada arquivo, buscando:
    • Bugs ou erros lógicos, como um nome de arquivo incompatível em script.js.
    • Falta tratamento de erros, por exemplo, o que acontece se events.json falhar ao carregar.
    • Problemas de acessibilidade, como alternativas de texto ausentes ou rótulos não claros.
    • Qualquer coisa que não esteja clara e que um futuro leitor possa ter dificuldade para entender.
  5. Para observar algo que você deseja alterar, passe o mouse sobre uma linha, clique , digite um comentário e clique em Comentário.

Opcional: obtendo uma segunda opinião de IA

Você também pode pedir Copilot Chat ao editor para revisar as mesmas alterações e oferecer uma segunda perspectiva.

  1. No seu editor, abra Copilot Chat.

  2. Peça que ele revise suas alterações usando um prompt como o seguinte.

    Text
    Review my changes for bugs, missing error handling, and accessibility issues.
    
  3. Leia as sugestões e decida quais delas melhoram seu recurso. Você está sempre no controle das alterações a serem feitas.

Dica

Se você gostou de usar Copilot para revisar seu próprio código, você pode se inscrever em um plano pago para obter créditos adicionais de IA e Copilot code review, que pode examinar suas solicitações de pull automaticamente quando você adicionar Copilot como um revisor.

Para obter mais informações, consulte Configurando GitHub Copilot por conta própria e Sobre a revisão do código do GitHub Copilot na GitHub Enterprise Cloud documentação.

Aplicando o feedback

Transforme as anotações de revisão e as Copilot Chat sugestões com as quais você concorda em atualizações.

  1. No editor, atualize os arquivos afetados para resolver o que você encontrou.
  2. Em GitHub Desktop, insira uma mensagem de commit, como Address review feedback, e clique em Confirmar # arquivos para adicionar à lista com estrela.
  3. Clique em Enviar para a origem para atualizar seu pull request com o novo commit.

Mesclando a solicitação de pull

Depois de estar satisfeito com suas alterações, mescle-as em main.

  1. No GitHub, volte para seu pull request e atualize a página.
  2. Clique na guia Conversa.
  3. Clique em Mesclar solicitação de pull e clique em Confirmar mesclagem.
  4. Clique em Excluir ramificação para limpar sua add-starred-list ramificação.

Verificando seu progresso

Atualize o quadro de projetos para refletir o trabalho concluído.

  1. No GitHub, acesse o quadro de projetos Stargazers log na guia Projetos do seu repositório.
  2. Arraste o Display a list of starred repositories item de Em Andamento para Concluído.

Se você tiver mais recursos para criar, crie novos problemas e mova-os para Em Andamento ao iniciar o próximo ciclo.

O fluxo de trabalho completo

Agora você percorreu todo o fluxo de trabalho do desenvolvedor:

  • Planejou o trabalho com um problema e uma placa de projeto.
  • Criou uma ramificação e desenvolveu sua funcionalidade.
  • Abriu uma solicitação de pull.
  • Revisou suas próprias alterações (com ajuda opcional de Copilot).
  • Mesclado seu recurso em main.
  • Atualizou sua placa de projeto para refletir seu progresso.

O que você realizou

TarefaResultado
Alterações revisadas na guia Arquivos alteradosVocê abriu a guia Arquivos alterados da solicitação de pull e leu a diferença.
Aplicou o feedback e recebeu assistência opcional de IAVocê aplicou alterações e, possivelmente, solicitou Copilot Chat uma revisão.
Mesclou sua funcionalidadeVocê mesclou suas alterações em main.
Progresso atualizadoVocê moveu o problema para Concluído em seu quadro de projetos.

Próximas Etapas