Recebendo feedback sobre seu código do GitHub Copilot

Sobre codificação colaborativa

Quando você está trabalhando com outras pessoas no GitHub, normalmente faz suas alterações em uma ramificação ou fork do projeto principal e as envia como uma solicitação de pull. 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 feedback e todos os seus benefícios do GitHub Copilot como alternativa.

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 de 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 ao lado de Copilot.

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é a página de novo repositório. Ao seguir este link, o modelo será pré-selecionado 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 "Mensagem de confirmação", insira algo como "Definir quadrados aleatoriamente ao carregar".

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 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á direcionado para sua nova solicitação de pull.

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.

   

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 seu 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 Configurando uma fonte de publicação para seu site GitHub Pages.