Przejdź do treści

Strona może być nieaktualna

Nikt jej nie zmieniał od 50 miesięcy (ostatni commit: 2022-08-23, Mateusz Sosnowski). Jeśli opisuje stan, którego już nie ma, zgłoś ją jako nieaktualną.

Dokumentacja Microservice-courier

Wersjonowanie

Streszczenie

Dla numeru wersji X.Y.Z, zwiększaj:

wersję X, gdy dokonujesz zmian niekompatybilnych z API,
wersję Y, gdy dodajesz nowe funkcjonalności dla dużego wydania,
wersję Z, gdy dokonujesz zmian dla wersji typu hotfix

Specyfikacja

  1. Standardowy numer wersji MUSI przyjąć formę X.Y.Z, gdzie X, Y i Z są nieujemnymi liczbami całkowitymi i NIE MOGĄ zawierać wiodących zer. X jest wersją major, Y wersją minor, a Z wersją patch. Każdy składnik MUSI rosnąć numerycznie. Przykładowo: 1.9.0 → 1.10.0 → 1.11.0.
  2. Po wydaniu wersjonowanego pakietu, zawartość tej wersji NIE MOŻE być modyfikowana. Jakiekolwiek zmiany MUSZĄ być wydane jako nowa wersja.
  3. Wersja zero (0.y.z) jest przeznaczona dla początkowej fazy rozwoju. Wszystko może ulec zmianie w dowolnym momencie. Aplikacja nie powinna być traktowana jako stabilna.
  4. Wersja Z (x.y.Z | x > 0) MUSI zostać zwiększona, jeśli wprowadza się tylko kompatybilne wstecz naprawy błędów. Naprawa błędu definiowana jest jako zmiana wewnętrzna, która usuwa nieprawidłowe działanie.
  5. Wersja Y (x.Y.z | x > 0) MUSI zostać zwiększona, jeśli nowa, kompatybilna wstecz funkcjonalność zostaje wprowadzona. MOŻE zostać zwiększona, jeśli wprowadzone zostają nowe znaczące funkcjonalności lub ulepszenia w obrębie prywatnego kodu. MOŻE ona zawierać zmiany na poziomie patch. Numer wersji Z MUSI być ustawiony na 0, gdy wersja Y jest zwiększana.
  6. Wersja X (X.y.z | X > 0) MUSI zostać zwiększona, jeżeli są wprowadzane jakiekolwiek wstecznie niekompatybilne zmiany. MOŻE zawierać zmiany na poziomie Y oraz Z. Numery wersji Y oraz Z MUSZĄ być ustawione na 0, gdy wersja X jest zwiększana.

Inspirowane: https://semver.org/lang/pl/

Ostatnia zmiana: 2022-08-23 · Mateusz Sosnowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e