Obter comentários sobre seu código no GitHub Copilot

Saiba como você pode solicitar que o GitHub Copilot examine as alterações de código e aplique as alterações sugeridas que ele cria.

Neste artigo

Sobre codificação colaborativa

Quando você está trabalhando com outras pessoas no GitHub, normalmente faz suas alterações em um branch ou bifurcação do projeto principal e as envia como uma pull request. Uma pull request mostra as diferenças entre o código original e suas alterações e convida o mantenedor do repositório a mesclar seu código no projeto.

Obter comentários sobre sua pull request de outras pessoas é uma parte importante do processo de desenvolvimento de software. As revisões de pull request melhoram o código específico em que você está trabalhando e também aprimoram suas habilidades de codificação e colaboração ao longo do tempo. Às vezes, especialmente quando você está aprendendo a codificar, talvez nem sempre você tenha alguém para pedir comentários. Nesses casos, você pode obter comentários e todos os seus benefícios do GitHub Copilot em vez disso.

Uma pull request é um local colaborativo em que você pode mostrar a outras pessoas as alterações que você está propondo e obter comentários. Ao solicitar uma revisão do Copilot, você aprenderá o mesmo processo que usará ao trabalhar com equipes de desenvolvimento. A única diferença é que você também solicitará revisões de colegas humanos junto com o Copilot.

Observação

O Revisão de código do Copilot no site do GitHub é um recurso Premium, disponível com os planos Copilot Pro, Copilot Pro+, Copilot Business e Copilot Enterprise. Para obter mais informações sobre como o uso de Revisão de código do Copilot afeta suas cotas, confira Como usar a revisão de código do GitHub Copilot. Se você é um estudante, poderá obter Copilot Pro gratuitamente. Confira Como obter acesso gratuito ao Copilot Pro como estudante, professor ou mantenedor.

1. Como criar o repositório de práticas

Neste exercício, você usará um repositório de exemplo com código existente. O repositório de exemplo é new2code/grid-toy, um pequeno projeto HTML e JavaScript que exibe uma grade de quadrados que mudam de cor. Este é um site GitHub Pages e você pode exibir a versão original em https://new2code.github.io/grid-toy.

Comece criando a sua cópia do repositório grid-toy.

  1. Navegue até new repository page. Seguir este link selecionará o modelo na conta new2code.
  2. Em "Owner", selecione sua conta de usuário.
  3. No campo "Repository name", digite "grid-toy".
  4. Clique em Criar repositório.

2. Fazer uma alteração

A seguir, você fará uma alteração no arquivo JavaScript.

  1. No novo repositório, clique em script.js na lista de arquivos.

  2. Para editar o arquivo JavaScript, na parte superior direita, clique em .

  3. Na linha 25, adicione o seguinte código:

    JavaScript
    if (Math.random() < INVERT_PROBABILITY) {
   cell.classes.add("black");
}

    Essa alteração define aleatoriamente alguns quadrados de grade como preto quando a página é carregada. Há um erro deliberado para disparar comentários de GitHub Copilot: a propriedade correta na verdade é .classList, não .classes. O GitHub Copilot deve nos ajudar a corrigir isso.

  4. Para confirmar a alteração, na parte superior direita, clique em Commit changes...

  5. No campo "Commit message", insira algo como "Randomly set squares on load".

  6. Selecione Criar uma nova ramificação para essa confirmação e iniciar uma solicitação de pull.

  7. Clique em Propor alterações.

3. Como criar uma pull request e solicitar uma revisão

Agora conclua a pull request e solicite uma revisão.

  1. Digite um título e, opcionalmente, uma descrição para sua pull request.
  2. Clique em Reviewers.
    • Se o Copilot aparecer na lista sugerida, clique em "Copilot".
    • Caso contrário, comece a digitar "Copilot" e clique no resultado.
  3. Clique em Criar solicitação de pull.

Você será levado para sua nova pull request.

4. Aplicar uma alteração sugerida

Em alguns minutos, o GitHub Copilot examinará sua solicitação de pull, produzirá um resumo e criará alterações sugeridas para os problemas encontrados.

  1. Aguarde até que a revisão do GitHub Copilot apareça.

  2. Uma dessas sugestões deve corrigir o erro intencional de antes, alterando .classes para .classList. Abaixo da alteração sugerida, clique em Commit suggestion.

    Captura de tela de uma alteração sugerida do GitHub Copilot. O botão "Commit suggestion" é realçado em uma estrutura de tópicos laranja.

  3. Clique em Confirmar alterações.

  4. É possível que o GitHub Copilot tenha encontrado outras melhorias e deixado comentários adicionais. Se você entender as alterações sugeridas, poderá aplicá-las também.

5. Mesclagem

Quando estiver satisfeito com as alterações, poderá mesclar a pull request. Isso adiciona as alterações do branch ao branch padrão do repositório (main).

  1. Na parte inferior da página, clique em Merge pull request.
  2. Opcionalmente, atualize a mensagem de confirmação.
  3. Pressione Confirm merge.

Próximas etapas

O projeto pode ser publicado usando o GitHub Pages. Agora que você fez algumas alterações, poderá publicar sua versão do repositório para vê-la em ação. Confira Configurar uma fonte de publicação para o site do GitHub Pages.