Tietoja: Conventional Commit -apuri — Yksityiskohtainen opas
Conventional Commit -generaattori muodostaa rakenteellisia Git-commit-viestejä Conventional Commits -määrityksen mukaisesti. Se opastaa kehittäjää valitsemaan tyypin (Type), skoopin (Scope), otsikkorivin (Subject), valinnaisen leipätekstin (Body) sekä alatunnisteen viittaukset (Footer).
Merkitse rikkoutuvat muutokset helposti huutomerkkisyntaksilla (`type!: description`), viittaa suljettuihin tehtäviin (`Closes #123`) ja luo standardoituja commit-viestejä, jotka tehostavat automaatiotyökaluja, kuten `semantic-release`-pakettia ja automaattisia muutoslokigeneraattoreita.
Keskeiset ominaisuudet ja toiminnot
- Täydellinen tyyppiluettelo: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
- Valinnainen skoopin syöttö ja reaaliaikaiset muistutukset otsikon pituudesta ja imperatiivimuodosta
- Yhden napsautuksen Breaking Change -valitsin, joka soveltaa standardia huutomerkkisyntaksia (`!`)
- Automaattinen asioiden linkitys alatunnisteeseen ja `git commit -m` -komennon kopiointi yhdellä napsautuksella
Käyttöohjeet
- 1
Valitse commitin tyyppi (esim. `feat` ominaisuuksille, `fix` virheenkorjauksille).
- 2
Määritä valinnainen skooppi (esim. `api`, `auth`) ja tiivis imperatiivimuotoinen kuvaus.
- 3
Tarkista koottu commit-merkkijono ja kopioi täysi `git commit` -komento päätteeseesi.
Yleiset käyttökohteet
- → Kehitystiimien perehdyttäminen yhtenäisiin Git-commithistorian käytäntöihin
- → Semanttisten versionkorotusten ja julkaisumuistiinpanojen automatisointi CI/CD-putkissa
- → Taaksepäin yhteensopimattomien API-muutosten (breaking changes) merkitseminen kirjastojen pääversiopäivityksissä
Vastaavat työkalut
Meta Tag & SEO -generaattori
Luo HTML-metatunnisteet, Open Graph- ja Twitter Card -tunnisteet esikatselulla hakukoneille.
.gitignore-generaattori
Luo mukautettu .gitignore-tiedosto valitsemalla käyttöjärjestelmät, kielet ja kehitystyökalut.
Avoimen lähdekoodin lisenssigeneraattori
Valitse ja luo suosittuja lisenssejä: MIT, Apache 2.0, GPL v3, BSD ja mukauta tekijätiedot.
README-generaattori
Luo GitHub-projektillesi ammattimainen README.md-tiedosto valmiilla osioilla ja badge-merkeillä.
SemVer-versiomuunnin
Validoi ja vertaa semanttisia versioita (SemVer), laske seuraavat versiot (major, minor, patch).
OpenAPI / Swagger -katselin
Tarkastele ja testaa OpenAPI 3.0 / Swagger -määrityksiä interaktiivisella dokumentaatiolla.
Usein kysytyt kysymykset ja tietosuoja
Mikä semanttisen version korotus vastaa kutakin commit-tyyppiä?
Tavallisten Conventional Commits -käytäntöjen mukaan `fix` käynnistää PATCH-korotuksen, `feat` käynnistää MINOR-korotuksen ja mikä tahansa commit, jossa on `BREAKING CHANGE`, käynnistää MAJOR-korotuksen.
Pitäisikö otsikkorivin päättyä pisteeseen?
Ei. Conventional Commits -suositusten mukaan käytetään tiivistä imperatiivimuotoista lausetta ilman loppupistettä (esim. `feat: allow user avatar upload`).