GITHUBGuide

Vincular branches e PRs a issues

Nomeie a branch com o código da issue — ou referencie a issue no PR — e o Forge mostra branches e PRs no painel Desenvolvimento da issue, podendo mover o status quando o PR é mesclado.

Crie a branch com o nome certo

  1. 1

    Abra a página completa da issue.

    O painel Desenvolvimento mostra o nome de branch sugerido. Ele não aparece no painel sobreposto — use Abrir página completa.

  2. 2

    Copie com `Copiar nome da branch` ou `Copiar comando git checkout`.

    A sugestão segue o padrão iss-N-..., com o número da issue — é o que vincula a branch à issue.

  3. 3

    Crie a branch e publique no GitHub.

    bash
    git checkout -b iss-42-corrigir-exportacao-csv
    resultado
    A branch aparece na issue, em “Branch já criada”, com link para o GitHub.

Vincule o PR

Um PR aberto a partir de uma branch iss-N-... já nasce vinculado. Sem a branch no padrão, escreva closes #N na descrição do PR — N é o número da issue. O painel mostra cada PR com o estado Aberto, Mesclado ou Fechado, com link para o GitHub.

Enquanto nada referencia a issue, o painel mostra “Nenhum PR vinculado” com a instrução de vínculo — siga os passos acima.

Mova a issue ao mesclar

Com a opção Fechar issues ao mesclar PR ativa na integração, mesclar um PR vinculado move a issue automaticamente para o status configurado pelo time — por exemplo, Concluído ou Pronto p/ deploy.

O ajudante de branch funciona sem o GitHub conectado

Os botões de copiar nome e comando aparecem em toda issue. Já a lista de PRs e a detecção de branches dependem da integração com o GitHub instalada.

Próximo