You can create default issue templates and a default configuration file for issue templates for your organization or personal account. Para obter mais informações, consulte "Criando um arquivo padrão de integridade da comunidade."
Criando modelos de problemas
- No your GitHub Enterprise Server instance, navegue até a página principal do repositório.
- No nome do seu repositório, clique em Configurações.
- Na seção "Features" (Recursos), em "Issues" (Problemas), clique em Set up templates (Configurar modelos).
- Use o menu suspenso Add template (Adicionar modelo) e clique no tipo de modelo que deseja criar.
- Para visualizar ou editar o modelo antes de fazer commit dele no repositório, clique em Preview and edit (Visualizar e editar).
- Para editar o modelo, clique em e digite nos campos para editar o conteúdo.
- Para definir automaticamente um título de problema padrão, atribua o problema a pessoas com acesso de leitura ao repositório ou aplique etiquetas ao modelo de problema. Informe esses detalhes em "Optional additional information" (Informações adicionais opcionais). Você também pode adicionar esses detalhes no modelo de problema com
title
,labels
ouassignees
em um formato de página inicial do YAML. - Quando tiver terminado de editar e visualizar o modelo, clique em Propose changes (Propor alterações) no canto superior direito da página.
- Insira uma mensagem do commit descrevendo as alterações.
- Abaixo dos campos de mensagem do commit, decida se vai fazer commit do seu modelo diretamente no branch padrão ou se vai criar um branch e abrir uma pull request. Para obter mais informações sobre pull requests, consulte "Sobre pull requests".
- Clique em Commit changes (Fazer commit das alterações). Assim que essas alterações passarem por merge no branch padrão, o modelo será disponibilizado para os contribuidores usarem quando abrirem novos problemas no repositório.
Configurando o seletor de modelos
Você pode personalizar o seletor do modelo de problema que as pessoas veem ao criar um novo problema no repositório, adicionando um arquivo config.yml � pasta .github/ISSUE_TEMPLATE
.
Você pode incentivar os contribuidores a usar modelos de problemas definindo blank_issues_enabled
para falso
. Se você configurar blank_issues_enabled
para verdadeiro
, as pessoas terão a opção de abrir um problema em branco.
Observação: Se você usou o fluxo de trabalho de legado para criar manualmente um arquivo issue_template.md
na pasta .github
e habilitar problemas em branco no seu arquivo config.yml, o modelo em issue_template.md
será usado quando as pessoas escolherem abrir um problema em branco. Se você desativar problemas em branco, o modelo nunca será usado.
Se você preferir receber determinados relatórios fora de GitHub Enterprise Server, você pode direcionar pessoas para sites externos com contact_links
.
Aqui está um exemplo de arquivo config.yml.
blank_issues_enabled: false
contact_links:
- name: Suporte � Comunidade GitHub
url: https://github.community/
about: Pergunte e responda dúvidas aqui.
- name: GitHub Recompensa de bug de segurança
url: https://bounty.github.com/
about: Reporte vulnerabilidades de segurança aqui.
Seu arquivo de configuração customizará o seletor de modelos quando o arquivo for mesclado ao branch padrão do repositório.
- No your GitHub Enterprise Server instance, navegue até a página principal do repositório.
- Acima da lista de arquivos, utilizando o menu suspenso Add file (Adicionar arquivo), clique em Create new file (Criar novo arquivo).
- No campo nome do arquivo, digite
.github/ISSUE_TEMPLATE/config.yml
. - No corpo do novo arquivo, digite o conteúdo do seu arquivo de configuração.
- 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, consulte "Criar um commit com vários co-autores."
- 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, consulte "Criar uma nova pull request."
- Clique em Propose new file.