Pravidla vydávání
Na co se můžete spolehnout.
Jak často Kaleta vychází, jak se weby aktualizují a co se nikdy nerozbije bez varování – pro váš vlastní web i pro weby, které stavíte klientům. Platí od Kalety 2.1.
Pravidelné tempo.
Nové menší vydání s funkcemi každý týden v kanálu Nejnovější, zhruba jednou za měsíc v kanálu Stabilní. Opravná a bezpečnostní vydání podle potřeby. Velké vydání nejvýš jednou za rok.
Aktualizace jedním krokem.
Podporovaná je poslední verze a web se starší verzí se na ni dostane jedním krokem v Nastavení → Zálohy a aktualizace, bez povinných zastávek mezi nimi. Každé vydání se testuje aktualizací instalací od verze 1.2 na MySQL i MariaDB.
Bezpečnost sama od sebe.
Bezpečnostní vydání se nainstalují samy, pokud správce automatické bezpečnostní aktualizace nevypne: web nejdřív zálohuje databázi a ověří podpis i kontrolní součet.
Nic nezmizí bez varování.
Než něco skončí, oznámí se to, ukáže se to ve Stavu systému na webech, které to používají, zůstane to aspoň dvě menší vydání a šest měsíců a odstraní se to jen ve velkém vydání.
Zaznamenaná smlouva.
Nástroje napojení Clauda, tokeny design systému, prvky builderu a rozšiřující API pro doplňky jsou zaznamenané v repozitáři. Testy selžou, když některý zmizí nebo se změní.
Veřejný záznam.
Každé vydání se oznamuje na GitHubu a v historii verzí tady na webu, anglicky, česky a německy.
Historie verzíKanály aktualizací
Nejnovější, nebo Stabilní.
Od Kalety 3.8 sleduje každý web jeden ze dvou kanálů aktualizací. Vyberete ho v Nastavení → Zálohy a aktualizace.
- Nejnovější – výchozí pro každý web. Nová menší verze každý týden a bezpečnostní vydání.
- Stabilní – jen bezpečnostní opravy a přechod na novější menší verzi zhruba jednou za měsíc, až když ta verze proběhla v kanálu Nejnovější. Webu ve Stabilním kanálu se nikdy nenabídne starší verze, než jakou má.
Oba kanály podepisuje stejný klíč vydavatele a ověřují se stejně.
Kompatibilita
Veřejná smlouva.
Pravidla výše platí pro:
- Napojení Clauda (MCP) – názvy nástrojů, parametry a jejich typy, povinné parametry a označení každého nástroje. Starší české názvy nástrojů fungují dál.
- Tokeny design systému – uložené názvy jako
--ka-barva-primarnii anglické jako--ka-color-primary. - Prvky builderu a jejich obsah, aby se každá uložená stránka dál zobrazila.
- Export webu – jde naimportovat do stejné nebo kterékoli pozdější verze.
- Adresy vašeho obsahu – aktualizace je nikdy nezmění; když změníte adresu stránky, novinky nebo kategorie, Kaleta přidá přesměrování.
- Kanál aktualizací a jeho podpisy.
Neplatí pro: PHP třídy, funkce a tabulky databáze, HTML administrace a přesný kód veřejných stránek a znění textů. Doplňky místo toho stavějí na verzovaném rozšiřujícím API (od Kalety 3.0, popis v docs/EXTENSIONS.md, anglicky), které má vlastní zaznamenanou smlouvu.
Celá pravidla
Pravidla jsou v repozitáři vedle kódu a každá jejich změna je veřejná (anglicky).