Enterprise Server 3.20 está disponível no momento como versão candidata a lançamento.

Vinculando uma pull request a um problema

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

Neste artigo

Sobre problemas e pull requests vinculados

Você pode vincular um problema a uma pull request manualmente ou usando uma palavra-chave com suporte na descrição da pull request, ou seja, o texto de resumo adicionado pelo autor quando criou a pull request.

Quando você vincula uma pull request ao problema que ela aborda, os colaboradores poderão ver que alguém está trabalhando nesse problema.

Quando você mescla uma pull request vinculada no branch padrão de um repositório, o problema vinculado será fechado automaticamente. Para saber mais sobre o branch padrão, confira Alterar o ramo padrão.

Observação

As palavras-chave especiais em uma descrição de pull request são interpretadas somente quando a pull request tem como destino o branch padrão do repositório. Se a pull request tem como alvo qualquer outro branch, essas palavras-chave serão ignoradas, nenhum link será criado e a mesclagem da pull request não afetará as issues.

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 um termo-chave para fazer referência a um comentário de outro 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.

Problema associadoSintaxeExemplo
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

As palavras-chave podem ser seguidas por dois pontos ou estar em maiúsculas. Por exemplo: Closes: #10, CLOSES #10, ou CLOSES: #10.

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 encerramento 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. Em GitHub, acesse a página principal do repositório.

  2. Abaixo do nome do repositório, clique em Pull requests.

    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. Clique em "Desenvolvimento" no pull request

  4. 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. Em GitHub, acesse a página principal do repositório.

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

    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

  •         [AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls#issues-and-pull-requests)