Návrh: Štandardizácia používania Conventional Commits.
Rád by som navrhol štandardizáciu na základe špecifikácie Conventional Commits.
Hlavný zmysel je lepší poriadok v commit správach a ich strojová spracovateľnosť. Tiež núti commitera viac sa zamyslieť nad tým, čo commit obsahuje, čo vo všeobecnosti zlepšuje obsah commitov.
Tiež by som navrhol užšiu špecifikáciu postavenú na danej špecifikácii. Navrhoval by som ju spresniť takto (iba zárodok):
- Všetko z Conventional Commits 1.0.0, plus:
-
description
je normálny slovenský text, teda postupnosť viet.feat: Toto je prvá veta. A toto je druhá.
- Nesprávne je
feat: logger
.
-
scope
sa používa takto:- Pre repozitár len s jednou logickou jednotkou (napr. špecifikácia): žiadny
scope
.fix: Preklep.
feat: Nová kapitola.
- Pre repozitár s kódom a dokumentáciou: rozdeliť kód a dokumentáciu pomocou
scope
.fix(documentation): Chybný odkaz.
feat(documentation): Návod na spustenie.
fix(application): Opravený bug #1234.
feat(application): Pridaná minihra.
- Pre repozitár len s jednou logickou jednotkou (napr. špecifikácia): žiadny
Edited by Peter Fačko