0Pricing
Git & GitHub Professional Workflow · Lekcja

Generowanie changelogów i informacji o wydaniach

Dowiedz się, jak tworzyć przejrzyste changelogi i automatyczne informacje o wydaniach na podstawie historii Git oraz conventional commits.

Generowanie changelogów i informacji o wydaniach to bezpłatna lekcja Git & GitHub Professional Workflow na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Git & GitHub Professional Workflow, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Git & GitHub Professional Workflow zawiera 4 lekcji w sumie.

Czym jest changelog

Changelog to uporządkowana, czytelna dla człowieka lista najważniejszych zmian dla każdej wersji. Znajduje się w pliku takim jak CHANGELOG.md w głównym katalogu repozytorium.

Dlaczego changelogi mają znaczenie

Użytkownicy i członkowie zespołu czytają changelogi, aby poznać:

  • Nowe funkcje
  • Poprawki błędów
  • Zmiany powodujące niezgodność

Dzięki nim aktualizacje są bezpieczniejsze i szybsze.

Format Keep a Changelog

Popularna konwencja grupuje wpisy pod nagłówkami: Dodane, Zmienione, Naprawione, Usunięte.

## [1.2.0] - 2024-05-01
### Added
- Search filters
### Fixed
- Login redirect bug

Conventional Commits

Conventional Commits wykorzystuje prefiksy takie jak feat:, fix: i BREAKING CHANGE:, dzięki czemu narzędzia mogą automatycznie tworzyć changelogi.

feat: add CSV export
fix: handle empty cart
feat!: drop Node 14 support

Wyświetlanie commitów od taga

Można wyświetlić podgląd zmian od ostatniego wydania, używając git log z zakresem tagów.

git log v1.1.0..HEAD --oneline

Czytelny log do notatek

Należy sformatować log do postaci wypunktowanych wierszy, które można wkleić do informacji o wydaniu.

git log v1.1.0..HEAD --pretty=format:'- %s'

Automatyczne narzędzia do tworzenia changelogów

Narzędzia takie jak standard-version lub conventional-changelog odczytują Conventional Commits i generują changelog oraz aktualizują numer wersji.

npx standard-version

Automatycznie generowane informacje o wydaniu w GitHubie

GitHub może automatycznie generować informacje o wydaniu na podstawie scalonych pull requestów podczas tworzenia wydania.

gh release create v1.2.0 --generate-notes

Kategoryzowanie za pomocą etykiet

Plik .github/release.yml mapuje etykiety PR-ów na sekcje changeloga, dzięki czemu informacje o wydaniu automatycznie grupują poprawki błędów i funkcje.

changelog:
  categories:
    - title: Features
      labels: [feature]

Przegląd przed publikacją

Zawsze należy przeczytać wygenerowane informacje przed ich opublikowaniem. Automatyzacja tworzy ich wersję roboczą, ale człowiek redaguje treść i wyróżnia zmiany powodujące niezgodność.

Łączenie z wydaniami

Każdy wpis changeloga powinien zawierać odnośnik do taga Git i strony wydania, aby czytelnicy mogli przejść do dokładnego diffu.

[1.2.0]: https://github.com/you/repo/compare/v1.1.0...v1.2.0

Szybkie sprawdzenie

Sprawdź swoją wiedzę na temat changelogów i informacji o wydaniu.

Podsumowanie

Dowiedziałeś się, jak generować changelogi:

  • Używaj formatu Keep a Changelog
  • Conventional Commits umożliwiają automatyzację
  • git log v1..HEAD wyświetla podgląd zmian
  • gh release create --generate-notes tworzy wersję roboczą informacji na podstawie PR-ów

Często zadawane pytania

Czy lekcja „Generowanie changelogów i informacji o wydaniach” jest bezpłatna?

Tak — pełny tekst „Generowanie changelogów i informacji o wydaniach” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Git & GitHub Professional Workflow, przejdź na CoddyKit PRO. Kurs Git & GitHub Professional Workflow zawiera 4 lekcji w sumie.

Co nauczysz się w „Generowanie changelogów i informacji o wydaniach”?

Dowiedz się, jak tworzyć przejrzyste changelogi i automatyczne informacje o wydaniach na podstawie historii Git oraz conventional commits. Ćwiczysz Git & GitHub Professional Workflow z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Git & GitHub Professional Workflow?

Nie wymagamy żadnego doświadczenia. Git & GitHub Professional Workflow w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.

Ile czasu zajmuje lekcja „Generowanie changelogów i informacji o wydaniach”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Git & GitHub Professional Workflow?

Tak. Każda lekcja Git & GitHub Professional Workflow zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Wersjonowanie semantyczne za pomocą tagów
  2. Tworzenie i zarządzanie wydaniami
  3. Gałęzie wydań i hotfixy
  4. Generowanie changelogów i informacji o wydaniach
← Powrót do Git & GitHub Professional Workflow