{"meta":{"title":"Автоматическое создание заметок о выпуске","intro":"Вы можете автоматически генерировать заметки к релизам для ваших релизов на GitHub","product":"Репозитории","breadcrumbs":[{"href":"/ru/repositories","title":"Репозитории"},{"href":"/ru/repositories/releasing-projects-on-github","title":"Выпуск проектов"},{"href":"/ru/repositories/releasing-projects-on-github/automatically-generated-release-notes","title":"Заметки об автоматическом выпуске"}],"documentType":"article"},"body":"# Автоматическое создание заметок о выпуске\n\nВы можете автоматически генерировать заметки к релизам для ваших релизов на GitHub\n\n## Сведения об автоматическом создании заметок о выпуске\n\nАвтоматическое создание заметок о выпуске — это альтернатива написанию заметок о выпуске на GitHub вручную. С помощью этой функции можно быстро создавать обзор содержимого выпуска. Автоматически созданные заметки о выпуске включают список объединенных запросов на вытягивание, список участников выпуска и ссылку на полный журнал изменений.\n\nАвтоматические заметки о выпуске можно также настроить с помощью меток, который позволяют создать пользовательские категории для упорядочения включаемых запросов на вытягивание. Кроме того, можно исключить определенные метки и пользователей из выходных данных.\n\n## Автоматическое создание заметок о выпуске для нового выпуска\n\n1. На GitHubперейдите на главную страницу репозитория.\n2. Справа от списка файлов щелкните **Выпуски**.\n\n \n3. В верхней части страницы нажмите кнопку **\"Черновик\" нового выпуска**.\n4. Чтобы выбрать тег выпуска, выберите раскрывающееся меню \" **Выбрать тег** \".\n * Чтобы использовать существующий тег, щелкните тег.\n * Чтобы создать новый тег, введите номер версии для выпуска и нажмите кнопку **\"Создать новый тег**\".\n5. Если вы создали новый тег, выберите **раскрывающееся меню \"Целевой** объект\", а затем щелкните ветвь, содержащую проект, который вы хотите освободить.\n6. При необходимости над полем описания выберите **раскрывающееся меню \"Предыдущий тег** \", а затем выберите тег, определяющий предыдущий выпуск.\n\n \n7. В поле \"Название выпуска\" введите название выпуска.\n8. Над полем описания нажмите кнопку **\"Создать заметки** о выпуске\".\n9. Проверьте созданные заметки, чтобы убедиться в том, что они содержат все сведения, которые необходимо включить, и ничего лишнего.\n10. Если в выпуск необходимо включить двоичные файлы, например скомпилированные программы, перетащите или вручную выберите файлы в области двоичных файлов.\n11. При необходимости, чтобы уведомить пользователей о том, что выпуск не готов к рабочей среде и может быть неустойчивым, выберите **это предварительная версия**.\n12. При необходимости выберите **\"Задать в качестве последнего выпуска**\". Если этот параметр не выбран, последняя метка выпуска будет автоматически назначена на основе семантического управления версиями.\n13. При необходимости, если для репозитория включен параметр GitHub Discussions, создайте обсуждение выпуска.\n * Выберите \" **Создать обсуждение\" для этого выпуска**.\n * **Выберите раскрывающееся меню \"Категория**\", а затем выберите категорию для обсуждения выпуска.\n14. Если вы готовы опубликовать выпуск, нажмите кнопку **Опубликовать выпуск**. Чтобы поработать над релизом позже, нажмите **«Сохранить черновик**». Если вы включили иммутабельные релизы для репозитория, создание черновика сначала позволяет прикрепить все ассеты до того, как релиз станет неизменным.\n Затем вы можете просмотреть опубликованные или черновики выпусков в веб-канале выпусков для репозитория. Дополнительные сведения см. в разделе [Просмотр выпусков и тегов репозитория](/ru/repositories/releasing-projects-on-github/viewing-your-repositorys-releases-and-tags).\n\n## Настройка автоматически созданных заметок о выпуске\n\n1. На GitHubперейдите на главную страницу репозитория.\n2. Над списком \\*\\*\\*\\* файлов выберите раскрывающееся меню , а затем щелкните ** Создать новый файл**.\n\n Кроме того, можно щелкнуть в представлении дерева файлов слева.\n\n \n3. В поле имени файла введите `.github/release.yml`. При этом будет создан новый файл, который вызывается `release.yml` в каталоге `.github` .\n4. Используя приведенные ниже параметры конфигурации, укажите в коде YAML файла метки запросов на вытягивание и авторов, которых следует исключить из этого выпуска. Вы также можете создать новые категории и перечислить метки запросов на вытягивание, которые должны быть включены в каждую из них.\n\n### Варианты конфигурации\n\n| Параметр | Описание |\n| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------- |\n| `changelog.exclude.labels` | Список меток, исключающих запрос на вытягивание из заметок о выпуске. |\n| `changelog.exclude.authors` | Список дескрипторов входа пользователей или ботов, запросы на вытягивание которых должны быть исключены из заметок о выпуске. |\n| `changelog.categories[*].title` | |\n| **Обязательно**. Название категории изменений в заметках о выпуске. | |\n| `changelog.categories[*].labels` | |\n| **Обязательно**. Метки, которые относят запрос на вытягивание к этой категории. Символу `*` будут соответствовать все запросы на вытягивание, которые не относятся ни к одной из предыдущих категорий. | |\n| `changelog.categories[*].exclude.labels` | Список меток, исключающих запрос на вытягивание из данной категории. |\n| `changelog.categories[*].exclude.authors` | Список дескрипторов входа пользователей или ботов, запросы на вытягивание которых должны быть исключены из данной категории. |\n\n### Примеры конфигураций\n\nКонфигурация для репозитория, который метки выпусков semver\n\n```yaml copy\n# .github/release.yml\n\nchangelog:\n exclude:\n labels:\n - ignore-for-release\n authors:\n - octocat\n categories:\n - title: Breaking Changes 🛠\n labels:\n - Semver-Major\n - breaking-change\n - title: Exciting New Features 🎉\n labels:\n - Semver-Minor\n - enhancement\n - title: Other Changes\n labels:\n - \"*\"\n```\n\nКонфигурация для репозитория, который не помечает запросы на вытягивание, но где мы хотим разделить Dependabot автоматические запросы на вытягивание в заметках о выпуске (`labels: '*'` требуется для отображения категории catchall)\n\n```yaml copy\n# .github/release.yml\n\nchangelog:\n categories:\n - title: 🏕 Features\n labels:\n - '*'\n exclude:\n labels:\n - dependencies\n - title: 👒 Dependencies\n labels:\n - dependencies\n```\n\n## Дополнительные материалы\n\n* [Управление метками](/ru/issues/using-labels-and-milestones-to-track-work/managing-labels)"}