Generator changelogu

Pisanie changelogu ręcznie oznacza przeczesywanie git log przy każdym wydaniu. Ten generator pomija ten krok: wklejasz wpisy, które chcesz opublikować, bezpośrednio do właściwej kategorii, Added, Changed, Fixed i Removed, dodajesz numer wersji i datę, a on tworzy sekcję Markdown w stylu Keep a Changelog gotową do wklejenia do CHANGELOG.md. Tę samą treść można też wygenerować jako zwykły tekst. Generator nie czyta Twojej historii git; to Ty decydujesz, które zmiany trafią do wydania.

Jak wygenerować changelog

  1. 1

    Wpisz wersję i datę

    Podaj numer wersji, na przykład 1.2.0. Pozostaw datę pustą, aby użyć dzisiejszej.

  2. 2

    Dodaj wpisy według kategorii

    Wklej notatki wydania do kategorii Added, Changed, Fixed i Removed, jeden wpis w wierszu. Puste kategorie są pomijane.

  3. 3

    Wybierz format wyjściowy

    Markdown (nagłówek `## [wersja] - data` z sekcjami w stylu `### Added`) albo zwykły tekst (nagłówek `v1.2.0 (data)` z listami punktowymi).

  4. 4

    Skopiuj changelog

    Wklej wynik nad poprzednim wpisem w pliku CHANGELOG.md.

Cztery kategorie

Generator tworzy dokładnie cztery sekcje, w tej kolejności: Added, Changed, Fixed i Removed. Nagłówki sekcji w wyniku pozostają po angielsku, zgodnie ze standardowym nazewnictwem Keep a Changelog.

Kategoria Kiedy używać
Added Nowe funkcje
Changed Zmiany w istniejącej funkcjonalności
Fixed Poprawki błędów
Removed Usunięte funkcje

Konwencja Keep a Changelog obejmuje też sekcje Deprecated, Security i Breaking. Generator nie ma pól dla nich; możesz dodać te sekcje ręcznie po wklejeniu wyniku.

Przykładowy wynik (Markdown)

## [1.4.0] - 2026-04-18

### Added
- Dark mode support for the dashboard (#312)
- CSV export on the users page (#318)

### Changed
- Upgrade React to 18.3 (#320)
- Pagination now defaults to 50 items per page (#322)

### Fixed
- Crash when editing users with a null email (#319)
- Timezone offset in scheduled reports (#321)

### Removed
- Legacy reports API (#324)

Przykładowy wynik (zwykły tekst)

v1.4.0 (2026-04-18)
ADDED:
  • Dark mode support for the dashboard (#312)
  • CSV export on the users page (#318)
CHANGED:
  • Upgrade React to 18.3 (#320)
  • Pagination now defaults to 50 items per page (#322)
FIXED:
  • Crash when editing users with a null email (#319)
  • Timezone offset in scheduled reports (#321)
REMOVED:
  • Legacy reports API (#324)

Wskazówki

  • Jeden wpis w wierszu. Każdy wiersz pola staje się jednym punktem. Puste pola są pomijane, a całą kategorię można zostawić bez wpisów.
  • Pisz wpisy jak linie changelogu, a nie jak notatki w logu. Forma rozkazująca „fix: handle null email on edit“ dobrze sprawdza się jako punkt.
  • Podawaj numery issue/PR, aby czytelnicy mogli drążyć temat: (#319) lub [#319](link) w wyniku.
  • Jedna wersja na wpis: nie łącz dwóch wydań w jeden blok, nawet jeśli dzieli je tylko jeden dzień.
  • Wydane czy niewydane: trzymaj na górze sekcję [Niewydane] ze zmianami przeznaczonymi na następną wersję. Przy wydaniu przenieś je do sekcji z datą.

Najczęściej zadawane pytania

Konwencji Keep a Changelog (keepachangelog.com): nagłówek wersji z datą i pogrupowane listy punktowe. Generator tworzy sekcje Added, Changed, Fixed i Removed; pozostałe standardowe sekcje (Deprecated, Security, Breaking) stosują tę samą konwencję, jeśli dodasz je ręcznie.

Generator tworzy cztery główne sekcje: Added, Changed, Fixed i Removed. Nie ma osobnych pól dla Deprecated, Security ani Breaking, ale możesz dodać te sekcje ręcznie do wygenerowanego tekstu przed wklejeniem.

Generator to jednorazowe narzędzie z interfejsem; do automatyzacji użyj CLI, takiego jak standard-version, release-please lub semantic-release, które wdrażają te same wzorce w Twoim potoku budowania.

Nie. Nie czyta Twojego repozytorium ani wiadomości commitów; wpisy wklejasz samodzielnie. Wprowadzany tekst jest wysyłany na serwer, aby zbudować wynik, i nie jest zapisywany ani udostępniany.

Powiązane narzędzia