Skip to main content

Criar modelos de pull request no repositório

Quando você adicionar um modelo de pull request ao repositório, os contribuidores do projeto verão automaticamente o conteúdo do modelo no texto da pull request.

Para obter mais informações, confira "Sobre os modelos de solicitações de pull e de problemas".

Crie um subdiretório PULL_REQUEST_TEMPLATE/ em uma das pastas compatíveis para conter vários modelos de solicitações de pull e use o parâmetro de consulta template para especificar o modelo que preencherá o corpo da solicitação de pull. Para obter mais informações, confira "Como usar parâmetros de consulta para criar uma solicitação de pull".

Você pode criar modelos de solicitações de pull padrão para sua conta de organização ou pessoal . Para obter mais informações, confira "Como criar um arquivo padrão de integridade da comunidade".

Adicionar um modelo de pull request

  1. No GitHub.com, navegue até a página principal do repositório. 1. Acima da lista de arquivos, usando o menu suspenso Adicionar arquivo, clique em Criar arquivo. "Criar arquivo" no menu suspenso "Adicionar arquivo"
  2. No campo nome do arquivo:
    • Para tornar o modelo de solicitação de pull visível no diretório raiz do repositório, dê ao modelo de solicitação de pull o nome pull_request_template.md. Novo nome do modelo de solicitação de pull no diretório raiz
    • Para tornar o modelo de solicitação de pull visível no diretório docs do repositório, dê ao modelo de solicitação de pull o nome docs/pull_request_template.md. Novo modelo de solicitação de pull no diretório docs
    • Para armazenar o arquivo em um diretório oculto, dê ao modelo de solicitação de pull o nome .github/pull_request_template.md. Novo modelo de solicitação de pull no diretório oculto
    • Para criar vários modelos de solicitações de pull e usar o parâmetro de consulta template para especificar um modelo para preencher o corpo da solicitação de pull, digite .github/PULL_REQUEST_TEMPLATE/ e o nome do modelo de solicitação de pull. Por exemplo, .github/PULL_REQUEST_TEMPLATE/pull_request_template.md. Você também pode armazenar vários modelos de solicitações de pull em um subdiretório PULL_REQUEST_TEMPLATE na raiz ou nos diretórios docs/. Para obter mais informações, confira "Sobre a automação para problemas e solicitações de pull com parâmetros de consulta". Vários novos modelos de solicitações de pull no diretório oculto
  3. No texto do novo arquivo, adicione seu modelo de pull request. Pode conter:
  4. No final da página, digite uma mensagem de commit curta e significativa que descreva a alteração feita no arquivo. Você pode atribuir o commit a mais de um autor na mensagem de commit. Para obter mais informações, confira "Como criar um commit com vários coautores". Mensagem de commit para a alteração 1. Abaixo dos campos de mensagem do commit, opte por adicionar o commit ao branch atual ou a um novo branch. Se seu branch atual for o branch-padrão, você deverá optar por criar um novo branch para seu commit e, em seguida, criar um pull request. Para obter mais informações, confira "Como criar uma solicitação de pull". Opções de commit no branch Os modelos estão disponíveis para os colaboradores quando eles forem mesclados no branch padrão do repositório.
  5. Clique em Propor novo arquivo. Botão Propor novo arquivo

Leitura adicional