Skip to main content

Configurando modelos de problemas em seu repositório

Você pode personalizar os modelos disponíveis para os contribuidores usarem quando abrirem novos problemas no seu repositório.

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

Criando modelos de problemas

  1. No your GitHub Enterprise Server instance, navegue até a página principal do repositório. 1. Abaixo do nome do repositório, clique em Configurações. Botão Configurações do repositório
  2. Na seção "Recursos", em "Problemas", clique em Configurar modelos. Botão Iniciar configuração do modelo
  3. Use o menu suspenso Add template (Adicionar modelo) e clique no tipo de modelo que deseja criar. Menu suspenso Adicionar modelo
  4. Para visualizar ou editar o modelo antes de fazer commit dele no repositório, clique em Visualizar e editar. Botão Visualizar e editar
  5. Para editar o modelo, clique em e digite os campos para editar o conteúdo deles. Botão Edição de modelo de problema
  6. 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). Adicione também esses detalhes no modelo de problema com title, labels ou assignees em um formato de frontmatter YAML. Informações adicionais para o modelo de problema
  7. Quando terminar de editar e visualizar o modelo, clique em Propor alterações no canto superior direito da página. Botão Propor alterações
  8. Insira uma mensagem do commit descrevendo as alterações. Campo de mensagem de commit do modelo de problema
  9. 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 solicitações de pull, confira "Sobre as solicitações de pull". Commit do modelo de problema com a opção Principal ou Abrir solicitação de pull
  10. Clique em 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 de modelo de problema que as pessoas veem ao criar um problema no seu repositório adicionando um arquivo config.yml à pasta .github/ISSUE_TEMPLATE.

Você pode incentivar os colaboradores a usar modelos de problema definindo blank_issues_enabled como false. Se você definir blank_issues_enabled como true, as pessoas terão a opção de abrir um problema em branco.

Observação: se você usou o fluxo de trabalho herdado para criar manualmente um arquivo issue_template.md na pasta .github e habilitar problemas em branco no arquivo config.yml, o modelo em issue_template.md será usado quando as pessoas optarem por abrir um problema em branco. Se você desativar problemas em branco, o modelo nunca será usado.

Se preferir receber determinados relatórios fora do GitHub Enterprise Server, você poderá direcionar as pessoas para sites externos com contact_links.

Este é um exemplo de arquivo config.yml.

YAML
blank_issues_enabled: false
contact_links:
  - name: GitHub Community Support
    url: https://github.com/orgs/community/discussions
    about: Please ask and answer questions here.
  - name: GitHub Security Bug Bounty
    url: https://bounty.github.com/
    about: Please report security vulnerabilities here.

Seu arquivo de configuração customizará o seletor de modelos quando o arquivo for mesclado ao branch padrão do repositório.

  1. No your GitHub Enterprise Server instance, 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 de nome do arquivo, digite .github/ISSUE_TEMPLATE/config.yml. Nome do arquivo de configuração
  3. No corpo do novo arquivo, digite o conteúdo do seu arquivo de configuração. Conteúdo do arquivo de configuração 1. 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 1. Clique em Propor novo arquivo. Botão Propor novo arquivo

Leitura adicional