Dziennik zmian
Dziennik zmian
Dział zatytułowany „Dziennik zmian”Ekosystem NextPDF obejmuje wiele pakietów i repozytoriów. Ta strona pokazuje, jak rejestrowane są w nim zmiany i gdzie każdy pakiet przechowuje własny dziennik zmian. Pełni funkcję indeksu i odniesienia do konwencji, a nie powtórzenia każdego commita. Każdy pakiet przechowuje miarodajny, opublikowany dziennik zmian we własnym repozytorium. Tabela podsumowująca agreguje wyłącznie kategorię zmiany w danej wydanej wersji, wyprowadzaną z historii Conventional Commits każdego repozytorium.
Jako indeks dokumentacji ta strona nie zawiera żadnych twierdzeń o zachowaniu któregokolwiek pakietu. Aby poznać reguły stosowane w każdym pakiecie przy zapisywaniu commitów i przygotowywaniu wydań, zobacz Konwencje dziennika zmian.
Jak rejestrowane są zmiany
Dział zatytułowany „Jak rejestrowane są zmiany”Każde publiczne repozytorium NextPDF przestrzega dwóch kontraktów:
- Conventional Commits 1.0.0 — temat każdego commita ma postać
type(scope): description, gdzietypeprzyjmuje jedną z wartości:feat,fix,perf,refactor,docs,test,build,ci,chorealborevert. Znak!po type/scope lub stopkaBREAKING CHANGE:oznacza zmianę niezgodną wstecz. Poprawki istotne dla bezpieczeństwa są oznaczane, aby można je było filtrować. - Semantic Versioning 2.0.0 —
featzwiększa wersję podrzędną (minor),fix/perfzwiększa wersję poprawki (patch), a zmiana niezgodna wstecz zwiększa wersję główną (major). Opublikowany plikCHANGELOG.mdw każdym repozytorium grupuje czytelne dla człowieka wpisy według wersji, w sekcjach zgodnych z Keep a Changelog.
Poniższe podsumowanie obejmuje wyłącznie kategorie widoczne dla użytkownika: feat (nowa funkcja), fix (poprawione zachowanie), perf (wydajność), security (poprawka istotna dla bezpieczeństwa) oraz zmiany niezgodne wstecz. Typy commitów o charakterze wyłącznie wewnętrznym (docs, test, ci, chore, refactor) są celowo pomijane w podsumowaniu obejmującym wiele repozytoriów. Nie wpływają na zachowanie widoczne podczas korzystania z pakietu.
Gdzie znajduje się dziennik zmian każdego pakietu
Dział zatytułowany „Gdzie znajduje się dziennik zmian każdego pakietu”Miarodajnym, opisowym dziennikiem zmian pakietu jest plik CHANGELOG.md w jego własnym repozytorium, pogrupowany według wydanych wersji. Aby zobaczyć pełną treść wpisu, skorzystaj ze strony wydania repozytorium albo z jego pliku CHANGELOG.md. Ten indeks nie powiela tej treści.
| Pakiet | Repozytorium | Miarodajny dziennik zmian |
|---|---|---|
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 (powiązania Python) | nextpdf-python | CHANGELOG.md |
Podsumowanie zbiorcze repozytoriów — kategorie według najnowszej wydanej wersji
Dział zatytułowany „Podsumowanie zbiorcze repozytoriów — kategorie według najnowszej wydanej wersji”Ta tabela tylko do odczytu jest generowana z historii Conventional Commits każdego repozytorium dla jego najnowszego tagu wydania. Zlicza kategorie widoczne dla użytkownika i podaje wyłącznie liczby w poszczególnych kategoriach — nigdy surowe tematy commitów — dzięki czemu nie ujawnia wewnętrznych identyfikatorów, nazw gałęzi ani odniesień do planowania. Aby poznać opisowe szczegóły dowolnego wiersza, sięgnij do pliku CHANGELOG.md danego pakietu.
| Pakiet | Najnowsza wydana | Nowa funkcja (feat) | Poprawki (fix) | Wydajność (perf) | Bezpieczeństwo | Niezgodne wstecz |
|---|---|---|---|---|---|---|
nextpdf/core | v5.2.0 | 317 | 290 | 1 | 1 | tak |
nextpdf/server | v0.1.0 | 15 | 16 | 0 | 0 | nie |
nextpdf/laravel | v0.1.0 | 1 | 8 | 0 | 0 | nie |
nextpdf/symfony | v0.1.0 | 1 | 7 | 0 | 0 | nie |
nextpdf/codeigniter | v0.1.0 | 1 | 10 | 0 | 0 | nie |
nextpdf/artisan | v0.1.0 | 1 | 7 | 0 | 0 | nie |
nextpdf/gotenberg | v0.1.0 | 0 | 6 | 0 | 0 | nie |
nextpdf/cloudflare | v0.1.0 | 0 | 8 | 0 | 0 | nie |
nextpdf/compat-legacy | v0.1.0 | 1 | 8 | 0 | 0 | nie |
nextpdf (Python) | v1.1.0 | 7 | 5 | 0 | 0 | nie |
Liczby są skumulowane do wskazanego tagu włącznie. W przypadku każdego pakietu integracyjnego pierwsze otagowane wydanie obejmuje całą jego historię sprzed wersji 1.0. Komórka „Niezgodne wstecz” pakietu
nextpdf/coreprzyjmuje wartośćyes, ponieważ silnik rdzeniowy publikował wersje główne ze zmianami niezgodnymi wstecz. Szczegóły dla poszczególnych wersji oraz ścieżka migracji dla każdej z nich znajdują się w plikuCHANGELOG.mdrepozytorium rdzeniowego oraz w jego przewodnikachmigration/. Ten indeks nie powtarza tych informacji.
Czego ta strona celowo nie zawiera
Dział zatytułowany „Czego ta strona celowo nie zawiera”Aby publiczny dziennik zmian nie ujawniał informacji wewnętrznych, ten indeks nigdy nie pokazuje żadnego z poniższych elementów:
- surowych tematów ani treści commitów;
- wewnętrznych identyfikatorów zgłoszeń, ticketów, cykli, fal ani elementów pracy;
- nazw prywatnych gałęzi ani niewydanych prac w toku;
- planu rozwoju ani niezapowiedzianych funkcji;
- informacji o współautorstwie przypisywanym automatyzacji.
Zmiana pojawia się tutaj dopiero wtedy, gdy stanie się częścią opublikowanej, otagowanej wersji publicznego pakietu. Niewydane prace nie są tu pokazywane.