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 uma pull request manualmente ou usando uma palavra-chave suportada na descrição da 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 uma solicitação de pull a um problema usando uma palavra-chave compatível na descrição do pull request ou em uma mensagem de commit (observe que a solicitação do pull deve estar no branch-padrão).
- close
- closes
- closed
- fix
- fixes
- fixed
- resolver
- resolve
- resolved
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 vinculadas manualmente podem ser desvinculadas. 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 GitHub Enterprise Server, 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.