Como usar o GitHub Codespaces em solicitações de pull

Você pode usar GitHub Codespaces no navegador da Web ou no Visual Studio Code para criar e examinar solicitações de pull, além de analisar comentários de revisão.

Neste artigo

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

Sobre as solicitações de pull do GitHub Codespaces

GitHub Codespaces fornece a você muitas das funcionalidades que você pode precisar para trabalhar com solicitações de pull:

  • Criar uma solicitação de pull – Usando os comandos do Terminal e do Git ou a exibição de "Controle do Código-Fonte", você pode criar solicitações de pull 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 uma solicitação de pull existente em um codespace, desde que tenha acesso de codespace no branch que está sendo mesclado.
  • Revisar uma solicitação de pull – Depois de abrir uma solicitação de pull em um codespace, use a exibição "Solicitação de Pull do GitHub" para adicionar comentários de revisão e aprovar solicitações de pull. Use também os GitHub Codespaces para ver comentários de revisão.

Abrir um pull request em Codespaces

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

    Captura de tela da página principal de um repositório. Na barra de navegação horizontal, uma guia, rotulada como "Solicitações de pull", é destacada em laranja escuro.

  2. Na lista de pull requests, clique no pull request que deseja 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 o branch de solicitação de pull e é aberto no editor padrão dos GitHub Codespaces.

Revendo um pull request em Codespaces

  1. Com o editor padrão definido como Visual Studio Code ou Visual Studio Code para Web, abra a pull request em um codespace, conforme a descrição em Como abrir uma pull request em Codespaces mostrada acima nesse artigo.

  2. Na Barra de Atividades, clique no ícone de solicitação de pull do Git para exibir a barra lateral "Solicitação de pull do GitHub". 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á passando o mouse sobre um ícone exibindo a dica de ferramenta "Solicitação de pull de GitHub".

    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 ao GitHub. Clique no ícone de GitHub 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 é realçado com um contorno laranja.

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

    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 resumido da sua revisão de solicitação de pull na barra lateral "Solicitação de pull do GitHub". 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 proposta em pull requests.

Visualizar de uma revisão em Codespaces

Depois de receber comentários sobre uma solicitação de pull, você pode abri-los em um codespace no navegador da Web ou no 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.