Criando pull requests empilhados

Crie solicitações de pull empilhadas com a extensão gh stack no GitHub CLI ou no site GitHub.

Criando uma pilha com GitHub CLI

1. Inicialize uma pilha. Isso cria e faz checkout da primeira branch na parte superior do seu branch trunk.

   Shell

   gh stack init BRANCH-NAME
   

2. Escreva o código para a primeira camada e, em seguida, adicione ao stage e faça commit das suas alterações.

   Shell

   git add .
   git commit -m "helpful-commit-message"
   

3. Adicione um branch para a próxima unidade lógica de trabalho. O novo branch é criado sobre o atual.

   Shell

   gh stack add BRANCH-NAME
   

4. Escreva código e faça commit no novo branch. Repita para cada camada adicional.

5. Efetue push de todos os branches para o repositório remoto e crie os pull requests em pilha no GitHub.

   Shell

   gh stack submit
   

   Cada pull request é criado com o branch base correto, para que os revisores vejam apenas a diferença para essa camada, e os pull requests são vinculados automaticamente entre si como uma pilha.

Criando uma pilha do GitHub site

Você pode criar uma pilha sem a CLI definindo o branch base de cada solicitação de pull para o branch abaixo dela.

1. Crie o primeiro pull request como faria normalmente. Normalmente, sua base seria direcionada a main.

2. Crie a próxima solicitação de pull e defina seu branch base para o branch da primeira solicitação de pull. Selecione a opção Create stack para vincular os dois pull requests como uma stack.

   Depois de criada, a pilha mostra os pull requests vinculados entre si.

   • Um ícone de pilha na parte superior do pull request mostra um número que indica qual camada você está exibindo.
   • Um mapa de agregação aparece na caixa de combinação. Ele mostra cada pull request na stack e seu status e permite que você navegue até qualquer camada com um clique.

3. Repita para cada solicitação de pull adicional, tendo como destino o branch da solicitação de pull anterior.

Transformando pull requests existentes em uma pilha de pull requests

Se você já tiver solicitações de pull abertas cujos branches se alinham, em que o branch base de cada solicitação de pull é o branch de cabeça da solicitação de pull abaixo, GitHub reconhece a cadeia e mostra uma oferta de banner de recomendação para transformá-las em uma pilha.

1. Em qualquer uma das pull requests qualificadas, selecione o banner para abrir uma caixa de diálogo que mostra uma prévia da pilha, listando cada pull request na ordem de cima para baixo.

2. Examine a visualização e confirme o vínculo dos pull requests em sequência.

Depois de confirmar isso, o stack map será exibido no cabeçalho de cada pull request.

Adicionar a uma pilha existente no site GitHub

Para adicionar uma nova solicitação de pull a uma pilha que já existe:

1. Abra qualquer solicitação de pull na pilha, clique no cabeçalho e clique em Adicionar à pilha.

2. A branch de base é automaticamente definida como o head da pull request no topo. Selecione o branch de origem para sua nova solicitação de pull e selecione Criar solicitação de pull.

3. Selecione Adicionar à pilha para criar a pull request.

A nova pull request foi adicionada à parte superior da pilha.

Leitura adicional

• Comandos da CLI de solicitações de pull empilhadas