Usando GitHub codespaces para solicitações de pull

Você pode usar GitHub Codespaces em seu navegador da Web ou no Visual Studio Code para criar pull requests, revisar pull requests e responder aos comentários de revisão.

Neste artigo

Usar um codespace para trabalhar em uma solicitação de pull oferece todos os benefícios de GitHub Codespaces. Para saber mais, confira recursos do GitHub Codespaces.

Sobre solicitações de pull em GitHub Codespaces

GitHub Codespaces fornece muitas das funcionalidades que talvez seja necessário para trabalhar com solicitações de pull:

  • Criar um pull request — usando o Terminal e comandos do Git ou a exibição "Controle do Código-Fonte", você pode criar pull requests da mesma forma que faria no GitHub. Se o repositório usar um modelo de pull request, você poderá usá-lo na visualização de "Controle do Código Fonte".
  • Abrir uma solicitação de pull – Você pode abrir um pull request existente em um codespace, desde que tenha acesso ao codespace do branch que está sendo mesclado.
  • Revise uma solicitação de pull - Depois de abrir uma solicitação de pull em um codespace, você pode usar a exibição "GitHub Solicitação de Pull" para adicionar comentários de revisão e aprovar solicitações de pull. Você também pode usar GitHub Codespaces para exibir comentários de revisão.

Abrindo um pull request em Codespaces

  1. No nome do repositório, clique em Solicitações pull.

  2. Na lista de pull requests, clique no pull request que você gostaria de abrir em Codespaces.

  3. No lado direito da tela, clique em Código.

  4. Na guia Codespaces, clique em .

    Captura de tela do menu suspenso "Código" com a guia "Codespaces" selecionada. A mensagem "Sem codespaces" é exibida. O botão de adição está realçado.

    Um codespace é criado para a branch da pull request e é aberto no editor padrão usado para GitHub Codespaces.

Revisando um pull request em Codespaces

  1. Com o editor padrão definido como Visual Studio Code ou Visual Studio Code para a Web, abra a pull request em um codespace, conforme descrito em Abrindo uma pull request em Codespaces anteriormente neste artigo.

  2. Na Barra de Atividades, clique no ícone de pull request do Git para exibir a barra lateral "GitHub Pull Request". Esse ícone só é exibido na Barra de Atividades quando você abre uma solicitação de pull em um codespace.

    Captura de tela da Barra de Atividades de VS Code. O ponteiro do mouse está pairando sobre um ícone exibindo o tooltip "GitHub Pull Request".

    Se você abriu uma solicitação de pull em um codespace e o ícone de solicitação de pull não é exibido na Barra de Atividades, verifique se você está conectado GitHub. Clique no GitHub ícone na Barra de Atividades e clique em Entrar.

    Captura de tela da barra lateral do GitHub mostrando o botão "Entrar". O ícone de GitHub na Barra de Atividades é destacado com um contorno laranja.

  3. Para examinar as alterações feitas em um arquivo específico, clique no nome do arquivo na barra lateral "GitHub Solicitação de Pull".

    Captura de tela da barra lateral de "Solicitação de pull do GitHub". O nome do arquivo é realçado com um contorno laranja escuro.

    Isso exibe uma exibição de comparação no editor, com a versão do arquivo do branch base à esquerda e a nova versão do arquivo, do branch principal da solicitação de pull, à direita.

  4. Para adicionar um comentário de revisão, clique no sinal de + ao lado do número de linha no arquivo exibido no lado direito do editor.

    Captura de tela da exibição de comparação. Na versão principal do arquivo, no lado direito do editor, o sinal de adição ao lado de uma linha está realçado.

  5. Digite seu comentário de revisão e clique em Iniciar Revisão.

    Captura de tela de um comentário sendo adicionado, lendo "Sim, eu concordo, assim está mais claro". O botão "Iniciar Revisão" é mostrado abaixo do comentário.

  6. Opcionalmente, você pode sugerir uma alteração em que o autor do pull request pode clicar para confirmar se concordar com sua sugestão. Para fazer isso, clique e mantenha pressionado o sinal + ao lado da primeira linha em que você deseja sugerir a alteração e, em seguida, arraste o sinal + para a última linha em que você deseja sugerir a alteração. Em seguida, clique em Fazer uma sugestão na caixa de comentários exibida.

    As linhas selecionadas são copiadas para a caixa de comentários, onde você pode editá-las para sugerir uma alteração. Você pode adicionar um comentário acima da linha que contém ```suggestion para explicar a alteração sugerida.

    Clique em Adicionar comentário para adicionar sua sugestão ao pull request.

    Captura de tela de uma alteração sugerida. Os botões "Fazer uma sugestão" e "Adicionar comentário" são mostrados abaixo da alteração sugerida.

  7. Quando terminar de adicionar comentários de revisão, você poderá adicionar um comentário de resumo para a revisão da sua pull request na barra lateral "GitHub Pull Request". Em seguida, você pode clicar em Comentar e Enviar ou clicar na seta de menu suspenso e selecionar Aprovar e Enviar ou Solicitar Alterações e Enviar.

    Captura de tela da barra lateral mostrando as opções suspensas "Comentar e Enviar", "Aprovar e Enviar" e "Solicitar Alterações e Enviar".

Para saber mais sobre como revisar uma pull request, confira Revisar alterações propostas em um pull request.

Exibir comentários de uma revisão em Codespaces

Depois de receber feedback sobre um pull request, você pode abri-lo em um codespace no navegador ou em VS Code, para ver os comentários de revisão. A partir de lá você pode responder a comentários, adicionar reações ou ignorar a revisão.