Vývoj
Changelog jako výstup buildu: konvence, automatizace, pipeline.
Začni tady: Keep a Changelog vysvětlen, se šablonou CHANGELOG.md, Od conventional commits k changelogu, Automatizace changelogu: co automatizovat a co ne
-
Co je hotfix? Význam, hotfix vs patch a jak ho vydat
Hotfix je naléhavá oprava vydaná mimo běžný cyklus vydávání. Co pojem znamená, čím se liší od patche nebo bugfixu a jak ho bezpečně vydat do produkce.
Vývoj5 min čtení
-
Release candidate (RC): co znamená a jak ho vést
Release candidate je build, který vyjde jako finální verze, pokud testy nenajdou blokující chybu. Místo RC po betě, verzování a pravidla pro ukončení.
Vývoj4 min čtení
-
CHANGELOG.md: co do něj patří a jak ho udržet aktuální
CHANGELOG.md je záznam pro čtenáře o tom, co se v každé verzi změnilo. Sekce, které potřebuje, úplný příklad a jediný návyk, který ho udrží aktuální.
Vývoj5 min čtení
-
GitHub release notes: vygenerujte je a udělejte je čitelné
GitHub navrhne release notes ze sloučených pull requestů na jedno kliknutí. Co návrh obsahuje, jak ho tvaruje release.yml a jaká úprava ho udělá čitelným.
Vývoj5 min čtení
-
Proces správy vydání pro týmy, které vydávají často
Proces správy vydání pro softwarové týmy v sedmi krocích, s vlastníkem a kritérii dokončení u každého, plus metriky DORA a jedno další KPI, které sledovat.
Vývoj7 min čtení
-
Kdo píše changelog, a kdo by měl
Kdo píše changelog? Autorka PR ví, co se změnilo, PM proč na tom záleží. Žádná sama užitečný záznam nenapíše a výchozí volba changelog nechá zastarat.
Vývoj5 min čtení
-
Formáty souborů changelogu: JSON, YAML nebo jen Markdown
Formát souboru changelogu rozhoduje, jestli může krmit stránku a widget zároveň, nebo ho čte jen člověk. Markdown, JSON a YAML stojí něco jiného.
Vývoj5 min čtení
-
Záznam changelogu povinně v GitHub Actions: workflow
Kontrola changelogu v GitHub Actions odmítne merge bez záznamu, protože krok závislý na paměti selhává podle vzorce. Jak ji nastavit a co rozbíjí.
Vývoj5 min čtení
-
Git tagy vs. GitHub releases vs. changelog
Git tag, release a záznam changelogu jsou tři záznamy jedné události. Jejich zaměňování nechává changelog odchýlit se. Jak by si tyto tři měly odpovídat.
Vývoj5 min čtení
-
Changelogy v monorepu: jeden, nebo jeden na balíček?
Monorepo může mít jeden changelog pro celé repo, nebo jeden na balíček. Špatná volba udělá z každého release čtení buď příliš hlučné, nebo roztříštěné.
Vývoj5 min čtení
-
Semantic versioning a váš changelog: co znamená každý skok
Semantic versioning říká volající straně, jak moc může bolet release, ještě než přečte slovo z changelogu. Co slibuje každé číslo, a co dluží záznam.
Vývoj5 min čtení
-
Veřejná changelog stránka: jak ji postavit a udržet
Changelog stránka se vyplatí, když se na ni lidé vracejí a čtou ji znovu. Kde by měla žít, co potřebuje záznam, feedy a markup, a kam patří widget.
Vývoj5 min čtení
-
Automatizace changelogu: co automatizovat a co ne
Automatizujte sběr, formátování a zveřejňování. Neautomatizujte výběr ani formulaci. Kde je hranice a co se stane pokaždé, když se ta hranice posune.
Vývoj6 min čtení
-
Od conventional commits k changelogu
Conventional commits dělají changelog odvoditelný. Nedělají ho čitelný. Co konvence poskytuje, kde se zastavuje, a jak přemostit tu mezeru mezi nimi.
Vývoj5 min čtení
-
Keep a Changelog vysvětlen, se šablonou CHANGELOG.md
Specifikace má jednu stránku a čte se deset minut. Zavádění je místo, kde se týmy odchylují. Co říká, co ponechává otevřené, a kde přesně selhává.
Vývoj5 min čtení