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 vinculado | Sintaxe | Exemplo |
---|---|---|
Problema no mesmo repositório | PALAVRA-CHAVE #NÚMERO-PROBLEMA | Closes #10 |
Problema em um repositório diferente | PROPRIETÁRIO DA PALAVRA-CHAVE/REPOSITÓRIO#NÚMERO-PROBLEMA | Fixes octo-org/octo-repo#100 |
Múltiplos problemas | Usar sintaxe completa para cada problema | Resolves #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.
-
Em GitHub, acesse a página principal do repositório.
-
Abaixo do nome do repositório, clique em Solicitações de pull.
-
Na lista de pull requests, clique na pull request que você gostaria de vincular a um problema.
-
Na barra lateral direita, clique em Desenvolvimento.
-
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.
-
Em GitHub, acesse a página principal do repositório.
-
No nome do seu repositório, clique em Problemas.
-
Na lista de problemas, clique no problema ao qual deseja vincular uma solicitação de pull ou um branch.
-
Na barra lateral direita, clique em Desenvolvimento.
-
Clique no repositório que contém a solicitação de pull ou o branch que você deseja vincular ao problema.
-
Clique na solicitação de pull ou no branch que você deseja vincular ao problema.
-
Clique em Aplicar.