Релизный процесс

Назначение

Этот гайд описывает, как версионируются и публикуются пакеты Nrgy.js. Большинству контрибьюторов и агентов запускать эти команды не нужно — релизы обычно выполняют мейнтейнеры.

Файлы, важные для релизов

• Корневой CHANGELOG.md фиксирует изменения уровня проекта.
• Пакетные CHANGELOG.md фиксируют изменения конкретных пакетов.
• Названия пакетов и команды установки должны браться из актуальных package.json.
• Правила версионирования живут в lerna.json.
• Релизные команды описаны в корневом package.json.

Подготовка релиза

1. Убедитесь, что в рабочем дереве находятся только нужные изменения.
2. Запустите npm run check.
3. Запустите npm run test.
4. Запустите npm run build.
5. Проверьте, что документация и записи в changelog обновлены.

Версионирование

Сначала используйте dry run:

npm run preview:new-version

Создавайте версии только после проверки dry run:

npm run new-version

• preview:new-version запускает lerna version --dry-run.
• new-version запускает lerna version с включёнными conventional commits.
• Перед версионированием хук preversion запускает npm run check, npm run build и npm run test, а затем добавляет все изменения через git add --all.

Публикация

После того как пакеты получили версии и релизный коммит готов, публикуйте пакеты с новыми версиями:

npm run new-publish

• new-publish запускает lerna publish from-package.
• Публикация пакетов опирается на версии, уже записанные в package manifest.

Релизные заметки и валидация

• После версионирования проверьте корневой CHANGELOG.md и пакетные CHANGELOG.md.
• Убедитесь, что сгенерированная документация и package README соответствуют публикуемому API.
• Если менялась документация сайта, перед публикацией соберите сайт через website/package.json.