Observação: As palavras-chave especiais na descrição de um pull request são interpretadas quando o pull request aponta para o branch-padrão do repositório. No entanto, se a base do PR's for qualquer outro branch, essas palavras-chave serão ignoradas, nenhum link será criado e o merge do PR não terá efeito sobre os problemas. Se você deseja vincular um pull request a um problema usando uma palavra-chave, o PR deverá estar no branch-padrão.
Sobre problemas e pull requests vinculados
Você pode vincular um problema a um pull request manualmente ou usar uma palavra-chave compatível na descrição do pull request.
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, consulte "Configurado o branch padrão. "
Vinculando uma pull request a um problema usando uma palavra-chave
Você pode vincular um pull request a um problema, usando uma palavra-chave suportada na descrição do pull request ou em uma mensagem de commit. O pull request deve estar no branch padrão.
- close
- closes
- closed
- fix
- fixes
- fixed
- resolver
- resolve
- 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 do pull request de referência também fecha o pull request referenciado.
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 pull requests vinculados manualmente podem ser desvinculados. Para desvincular um problema que você vinculou usando uma palavra-chave, você deve editar a descrição da pull request 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.
Vinculando manualmente uma pull request a um problema
Qualquer pessoa com permissões de gravação em um repositório pode vincular manualmente uma pull request a um problema.
Você pode vincular manualmente até dez problemas para cada pull request. O problema e a pull request devem estar no mesmo repositório.
-
No your GitHub Enterprise Server instance, navegue até a página principal do repositório.
-
Abaixo do nome do seu repositório, clique em Pull requests.
-
Na lista de pull requests, clique na pull request que você gostaria de vincular a um problema.
-
Na barra lateral direita, clique em Linked issues (Problemas vinculados)
-
Clique no problema que você deseja associar � pull request.
