> Źródło: https://redai.pl/dev/wersje-i-lista-zmian/ (dokumentacja modułów portalu redAi). Cała dokumentacja w jednym pliku: https://redai.pl/dev/moduly.md

## Wersje i lista zmian

- `wersja` to semver `x.y.z`: trzy liczby, bez przyrostków typu `-beta`.
  - `z` (poprawka): błąd naprawiony, nic nowego dla użytkownika.
  - `y` (funkcja): nowa możliwość, stare dane i ekrany działają dalej.
  - `x` (zmiana łamiąca): np. zmiana danych, która wymaga uwagi administratora.
- **Każda wysyłka musi mieć wyższy numer** niż ostatnia wysłana wersja tego modułu (także odrzucona). Numery porównujemy jak `version_compare` w PHP.
- `zmiany` to lista zmian dla użytkownika, najnowsza wersja pierwsza. Administrator widzi ją w karcie modułu przed aktualizacją, więc piszcie po ludzku, co się zmieniło dla nich, nie nazwy klas.
- `wymaga_portalu`: jeśli moduł używa czegoś, co weszło w konkretnej wersji portalu, wpiszcie tę wersję. Instancja ze starszym portalem nie dostanie modułu ani aktualizacji, dopóki portal się nie podniesie. Katalog modułów działa na portalach od 1.3.20.