Список изменений
Список изменений
Заголовок раздела «Список изменений»Экосистема NextPDF охватывает множество пакетов и репозиториев. На этой странице показано, как экосистема фиксирует изменения и где у каждого пакета находится собственный список изменений. Используйте её как указатель и справочник по соглашениям, а не как пересказ каждого коммита. Каждый пакет ведёт официальный опубликованный список изменений в своём репозитории. Сводная таблица собирает только категории изменений по выпущенным версиям, выведенные из истории Conventional Commits каждого репозитория.
Это справочная страница, поэтому она не делает заявлений о поведении какого-либо пакета. Чтобы увидеть правила, которым следует каждый пакет при написании коммитов и подготовке выпусков, см. Соглашения по списку изменений.
Как фиксируются изменения
Заголовок раздела «Как фиксируются изменения»Каждый публичный репозиторий NextPDF соблюдает два контракта:
- Conventional Commits 1.0.0 — заголовок каждого коммита имеет вид
type(scope): description, гдеtype— одно изfeat,fix,perf,refactor,docs,test,build,ci,choreилиrevert. Символ!после type/scope или footerBREAKING CHANGE:отмечает несовместимое изменение. Исправления, связанные с безопасностью, помечаются, чтобы их можно было отфильтровать. - Semantic Versioning 2.0.0 —
featповышает минорную версию,fix/perfповышает патч-версию, а несовместимое изменение повышает мажорную версию. Опубликованный файлCHANGELOG.mdв каждом репозитории группирует читаемые записи по версиям, используя разделы Keep a Changelog.
Приведённая ниже сводка охватывает только видимые пользователю категории: feat (новая возможность), fix (исправленное поведение), perf (производительность), security (исправление, связанное с безопасностью) и несовместимые изменения. Внутренние типы коммитов (docs, test, ci, chore, refactor) намеренно исключены из межрепозиторной сводки. Они не меняют того, что вы видите при использовании пакета.
Где находится список изменений каждого пакета
Заголовок раздела «Где находится список изменений каждого пакета»Официальный текстовый список изменений пакета — это файл CHANGELOG.md в собственном репозитории этого пакета, сгруппированный по выпущенным версиям. Полный текст записей см. на странице релизов репозитория или в его файле CHANGELOG.md. Этот указатель его не дублирует.
| Пакет | Репозиторий | Авторитетный список изменений |
|---|---|---|
nextpdf/core | nextpdf | CHANGELOG.md (Keep a Changelog) |
nextpdf/server | nextpdf-server | CHANGELOG.md |
nextpdf/laravel | nextpdf-Laravel | CHANGELOG.md |
nextpdf/symfony | nextpdf-Symfony | CHANGELOG.md |
nextpdf/codeigniter | nextpdf-CodeIgniter | CHANGELOG.md |
nextpdf/artisan | nextpdf-Artisan | CHANGELOG.md |
nextpdf/gotenberg | nextpdf-Gotenberg | CHANGELOG.md |
nextpdf/cloudflare | nextpdf-Cloudflare | CHANGELOG.md |
nextpdf/compat-legacy | nextpdf-compat-tcpdf | CHANGELOG.md |
nextpdf (привязки для Python) | nextpdf-python | CHANGELOG.md |
Межрепозиторная сводка — категории по последней выпущенной версии
Заголовок раздела «Межрепозиторная сводка — категории по последней выпущенной версии»Эта таблица доступна только для чтения и формируется из истории Conventional Commits каждого репозитория на его последнем выпущенном теге. Она подсчитывает видимые пользователю категории и показывает только количество по категориям — никогда не приводит исходные заголовки коммитов — поэтому не раскрывает внутренние идентификаторы, имена веток или ссылки на планирование. Текстовые подробности по любой строке см. в собственном файле CHANGELOG.md пакета.
| Пакет | Последний выпуск | Новая возможность (feat) | Исправления (fix) | Производительность (perf) | Безопасность | Несовместимые |
|---|---|---|---|---|---|---|
nextpdf/core | v5.2.0 | 317 | 290 | 1 | 1 | да |
nextpdf/server | v0.1.0 | 15 | 16 | 0 | 0 | нет |
nextpdf/laravel | v0.1.0 | 1 | 8 | 0 | 0 | нет |
nextpdf/symfony | v0.1.0 | 1 | 7 | 0 | 0 | нет |
nextpdf/codeigniter | v0.1.0 | 1 | 10 | 0 | 0 | нет |
nextpdf/artisan | v0.1.0 | 1 | 7 | 0 | 0 | нет |
nextpdf/gotenberg | v0.1.0 | 0 | 6 | 0 | 0 | нет |
nextpdf/cloudflare | v0.1.0 | 0 | 8 | 0 | 0 | нет |
nextpdf/compat-legacy | v0.1.0 | 1 | 8 | 0 | 0 | нет |
nextpdf (Python) | v1.1.0 | 7 | 5 | 0 | 0 | нет |
Подсчёты приведены накопительно до указанного тега. Для каждого интеграционного пакета первый выпуск с тегом включает всю его историю до версии 1.0. Ячейка “Несовместимые” для
nextpdf/coreсодержитyes, потому что в основном движке были несовместимые мажорные версии. Сведения о каждой версии и путь миграции для каждой из них находятся в файлеCHANGELOG.mdрепозитория ядра и в его руководствахmigration/. Этот указатель не повторяет их.
Что эта страница намеренно не включает
Заголовок раздела «Что эта страница намеренно не включает»Чтобы в публичный список изменений не попали внутренние сведения, этот указатель никогда не раскрывает:
- исходные заголовки или тела коммитов;
- внутренние идентификаторы задач, тикетов, циклов, волн или рабочих элементов;
- имена приватных веток или незавершённую работу;
- дорожную карту или необъявленные возможности;
- атрибуцию автоматизации участников.
Изменение появляется здесь только после того, как войдёт в выпущенную и помеченную тегом версию публичного пакета. Незавершённая работа здесь не отображается.