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.
closeclosesclosedfixfixesfixedresolveresolvesresolved
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 | KEYWORD #ISSUE-NUMBER | Closes #10 |
| Problema em um repositório diferente | KEYWORD OWNER/REPOSITORY#ISSUE-NUMBER | 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.
-
No sua empresa, navegue até a página principal do repositório. 1. 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.
