Создание одного шаблона проблем для репозитория вручную

Можно создать подкаталог ISSUE_TEMPLATE/ в любой из поддерживаемых папок, чтобы он содержал шаблоны для нескольких проблем, и использовать параметр запроса template, чтобы указать шаблон, который будет заполнять текст проблемы. Дополнительные сведения см. в разделе Создание проблемы.

Можно добавить титульный лист YAML в каждый шаблон проблемы, чтобы предварительно заполнить заголовок проблемы, автоматически добавлять метки и назначаемые элементы, а также присваивать шаблону имя и описание, которые будут отображаться в средстве выбора шаблона, который пользователи видят при создании новой проблемы в репозитории.

Ниже приведен пример титульного листа YAML.

---
name: Tracking issue
about: Use this template for tracking new features.
title: "[DATE]: [FEATURE NAME]"
labels: tracking issue, needs triage
assignees: octocat
---

Вы можете создать шаблоны проблем по умолчанию и файл конфигурации по умолчанию для шаблонов проблем для вашей организации или личной учетной записи. Дополнительные сведения см. в разделе Создание файла работоспособности сообщества по умолчанию..

Добавление шаблона проблемы

1. На экземпляр GitHub Enterprise Server перейдите на главную страницу репозитория.

2. Над списком файлов в раскрывающемся списке Добавить файл щелкните Создать файл.

3. В поле имени файла:

   • Чтобы сделать шаблон проблемы видимым в корневом каталоге репозитория, введите имя issue_template. Например, issue_template.md.
   • Чтобы сделать шаблон проблемы видимым в корневом каталоге репозитория docs, введите docs/ , а затем имя issue_template. Например, , docs/issue_template.md
   • Чтобы сохранить файл в скрытом каталоге, введите .github/ , а затем имя issue_template. Например, .github/issue_template.md.
   • Чтобы создать шаблоны для нескольких проблем и использовать параметр запроса template, чтобы указать шаблон для заполнения текста проблемы, введите .github/ISSUE_TEMPLATE/, , а затем имя шаблона проблемы. Например, .github/ISSUE_TEMPLATE/issue_template.md. Можно также хранить шаблоны для нескольких проблем в подкаталоге ISSUE_TEMPLATE в корне или каталогах docs/. Дополнительные сведения см. в разделе Создание проблемы.

4. Добавьте шаблон проблемы в текст нового файла. Это может быть:

   • Титульный лист YAML
   • Ожидаемое поведение и фактическое поведение
   • Шаги по воспроизведению проблемы
   • Спецификации, такие как версия проекта, операционной системы или оборудования

5. В поле "Сообщение о фиксации" введите короткое осмысленное сообщение о фиксации, описывающее изменения, внесенные в файл. В таком сообщении фиксацию можно отнести к нескольким авторам. Дополнительные сведения см. в разделе Создание фиксации с несколькими авторами. 1. Под полями сообщения о фиксации укажите, куда следует добавить фиксацию: в текущую ветвь или в новую. Если текущей ветвью является ветвь по умолчанию, нужно создать новую ветвь для фиксации, а затем создать запрос на вытягивание. Дополнительные сведения см. в разделе Создание запроса на включение изменений.

   Шаблоны доступны участникам совместной работы при слиянии их в ветвь по умолчанию репозитория.

6. Нажмите кнопку Зафиксировать изменения или Предложить изменения.

Дополнительные материалы

• "Сведения о шаблонах проблем и запросов на вытягивание"
• "Настройка шаблонов проблем для репозитория"
• "Создание проблемы"