Skip to main content

Vinculando uma pull request a um problema

Você pode vincular uma solicitação de pull ou um branch a um problema para mostrar que uma correção está em andamento e fechar automaticamente o problema quando a solicitação de pull ou branch for mesclada.

Observação: as palavras-chave especiais em uma descrição de solicitação de pull são interpretadas quando a solicitação de pull tem como destino o branch padrão do repositório. No entanto, se a base da PR for qualquer outro branch, essas palavras-chave serão ignoradas, nenhum vínculo será criado e a mesclagem da PR não terá nenhum efeito sobre os problemas. Caso você deseje vincular uma solicitação de pull a um problema usando uma palavra-chave, a PR precisa estar no branch padrão.

Sobre problemas e pull requests vinculados

Você pode vincular um problema a uma solicitação de pull manualmente ou usando uma palavra-chave com suporte na descrição da solicitação de pull.

Quando você vincula uma pull request ao problema que a pull request tem de lidar, os colaboradores poderão ver que alguém está trabalhando no problema.

Quando você mescla uma pull request vinculada no branch padrão de um repositório, o problema vinculado será fechado automaticamente. Para obter mais informações sobre o branch padrão, confira "Alterar o branch-padrão".

Vinculando uma pull request a um problema usando uma palavra-chave

Você pode vincular uma solicitação de pull a um problema usando uma palavra-chave com suporte na descrição da solicitação de pull ou em uma mensagem de commit. A solicitação de pull deve estar no branch padrão.

  • close
  • closes
  • closed
  • fix
  • fixes
  • fixed
  • resolve
  • resolves
  • resolved

Se você usar uma palavra-chave para fazer referência a um comentário de um pull request em outr pull request, os pull requests serão vinculados. O merge da solicitação de pull de referência também fechará a solicitação de pull referenciada.

A sintaxe para fechar palavras-chave depende se o problema está no mesmo repositório que a pull request.

Problemas vinculadoSintaxeExemplo
Problema no mesmo repositórioPALAVRA-CHAVE #NÚMERO-PROBLEMACloses #10
Problema em um repositório diferentePROPRIETÁRIO DA PALAVRA-CHAVE/REPOSITÓRIO#NÚMERO-PROBLEMAFixes octo-org/octo-repo#100
Múltiplos problemasUsar sintaxe completa para cada problemaResolves #10, resolves #123, resolves octo-org/octo-repo#100

Somente as solicitações de pull vinculadas manualmente podem ser desvinculadas manualmente. Para desvincular um problema que você vinculou usando uma palavra-chave, você deve editar a descrição da solicitação de pull para remover a palavra-chave.

Você também pode usar palavras-chave de fechamento em uma mensagem de commit. O problema será encerrado quando você mesclar o commit no branch padrão, mas o pull request que contém o commit não será listado como um pull request vinculado.

Como vincular manualmente uma solicitação de pull a um problema usando a barra lateral de solicitação de pull

Qualquer pessoa com permissões de gravação em um repositório pode vincular manualmente uma solicitação de pull a um problema usando a barra lateral de solicitação de pull.

Você pode vincular manualmente até dez problemas para cada pull request. O problema e a pull request devem estar no mesmo repositório.

  1. No GitHub.com, navegue até a página principal do repositório.

  2. 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.

  3. Na lista de pull requests, clique na pull request que você gostaria de vincular a um problema.

  4. Na barra lateral direita, clique em Desenvolvimento.

    Captura de tela da barra lateral do problema. "Desenvolvimento" tem o contorno em laranja escuro.

  5. Clique no problema que você deseja associar à pull request.

Como vincular manualmente uma solicitação de pull ou um branch a um problema usando a barra lateral de problema

Qualquer pessoa com permissões de gravação em um repositório pode vincular manualmente uma solicitação de pull ou um branch a um problema usando a barra lateral de problema.

Você pode vincular manualmente até dez problemas para cada pull request. O problema pode estar em um repositório diferente da solicitação de pull ou do branch vinculado. O último repositório selecionado será lembrado.

  1. No GitHub.com, navegue até a página principal do repositório.

  2. No nome do seu repositório, clique em Problemas.

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

  3. Na lista de problemas, clique no problema ao qual deseja vincular uma solicitação de pull ou um branch.

  4. Na barra lateral direita, clique em Desenvolvimento.

    Captura de tela da barra lateral do problema. "Desenvolvimento" tem o contorno em laranja escuro.

  5. Clique no repositório que contém a solicitação de pull ou o branch que você deseja vincular ao problema.

  6. Clique na solicitação de pull ou no branch que você deseja vincular ao problema.

  7. Clique em Aplicar.

Leitura adicional