Inginerie
Changelogul ca artefact de build: convenții, automatizare, pipeline-uri.
Începe aici: Keep a Changelog explicat, cu un șablon CHANGELOG.md, De la conventional commits la un changelog, Automatizarea changelog-ului: ce automatizezi și ce nu
-
Ce este un hotfix? Sens, hotfix vs patch, cum îl livrezi
Un hotfix este o remediere urgentă livrată în afara ciclului normal de lansare. Ce înseamnă, cum diferă de un patch sau bugfix și cum îl livrezi sigur.
Inginerie6 min de citit
-
Release candidate (RC): ce înseamnă și cum îl rulezi
Un release candidate este buildul livrat ca versiune finală dacă testarea nu găsește blocaje. Locul după beta, versionarea și criteriile de ieșire.
Inginerie5 min de citit
-
CHANGELOG.md: ce conține și cum îl ții la zi
Un CHANGELOG.md e înregistrarea pentru cititori a ce s-a schimbat în fiecare versiune. Secțiunile necesare, un exemplu întreg și obiceiul care îl ține viu.
Inginerie6 min de citit
-
Release notes pe GitHub: generează-le, apoi fă-le lizibile
GitHub redactează release notes din pull request-urile integrate cu un clic. Ce conține ciorna, cum o modelează release.yml și editarea care o face clară.
Inginerie6 min de citit
-
Procesul de gestionare a lansărilor, în șapte pași
Un proces de gestionare a lansărilor în șapte pași, cu responsabil și criterii de ieșire pentru fiecare, plus metricile DORA și un indicator în plus.
Inginerie8 min de citit
-
Cine scrie changelog-ul, și cine ar trebui
Cine scrie changelog-ul? Autoarea PR-ului știe ce s-a schimbat, PM-ul de ce contează. Niciuna singură nu scrie o intrare utilă, iar una îl învechește.
Inginerie5 min de citit
-
Formate de fișier pentru changelog: JSON, YAML sau Markdown
Formatul fișierului de changelog decide dacă poate alimenta o pagină și un widget sau doar e citit. Markdown, JSON și YAML costă lucruri diferite.
Inginerie6 min de citit
-
Intrare de changelog obligatorie în GitHub Actions
Un check de changelog în GitHub Actions refuză merge-ul fără intrare, pentru că un pas bazat pe memorie eșuează după un tipar. Și ce strică acel check.
Inginerie6 min de citit
-
Tag-uri Git vs lansări GitHub vs changelog
Un tag git, o lansare, o intrare de changelog: trei înregistrări ale aceluiași eveniment. Dacă le confundați, changelog-ul deviază. Cum se potrivesc.
Inginerie6 min de citit
-
Changelog-uri de monorepo: unul singur, sau unul pe pachet?
Un monorepo poate avea un changelog pentru tot repo-ul sau unul pe pachet, iar alegerea greșită face lansările fie prea zgomotoase, fie prea dispersate.
Inginerie6 min de citit
-
Semantic versioning și changelog: ce înseamnă fiecare salt
Semantic versioning spune cât de mult poate durea o lansare înainte să citești un cuvânt din changelog. Ce promite fiecare cifră, ce datorează o intrare.
Inginerie6 min de citit
-
Pagină publică de changelog: cum o construiești
Merită construită când cineva revine la ea. Unde locuiește, de ce are nevoie fiecare intrare, fluxuri și markup, și unde se potrivește widget-ul.
Inginerie6 min de citit
-
Automatizarea changelog-ului: ce automatizezi și ce nu
Automatizați colectarea, formatarea și publicarea changelog-ului, dar nu selecția sau formularea. Unde se află linia și ce se întâmplă când se mută.
Inginerie6 min de citit
-
De la conventional commits la un changelog
Conventional commits fac un changelog derivabil. Nu-l fac lizibil. Ce oferă convenția, unde se oprește, și cum se umple diferența dintre ele.
Inginerie6 min de citit
-
Keep a Changelog explicat, cu un șablon CHANGELOG.md
Specificația e o pagină și durează zece minute de citit. Implementarea e locul unde echipele se abat. Ce spune, ce lasă deschis, și unde greșește.
Inginerie6 min de citit