Quant a Generador de Conventional Commits — Guia detallada
El generador de Conventional Commits crea missatges de commit de Git estructurats que compleixen l'especificació Conventional Commits. Guia els desenvolupadors a l'hora de triar el tipus (Type), l'abast (Scope), la línia d'assumpte (Subject), la descripció del cos opcional (Body) i les referències del peu (Footer).
Indica fàcilment canvis que trenquen la compatibilitat amb la sintaxi del signe d'exclamació (`type!: description`), referencia incidències resoltes (`Closes #123`) i genera missatges de commit estandarditzats compatibles amb eines automatitzades com `semantic-release` i generadors automàtics de registres de canvis (changelog).
Funcions i capacitats clau
- Catàleg complet de tipus: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
- Camp d'abast (scope) opcional i recordatoris en temps real de longitud de l'assumpte i redacció en imperatiu
- Commutador de canvi incompatible (Breaking Change) amb un sol clic que aplica la sintaxi estàndard del signe d'exclamació (`!`)
- Generador de peus amb enllaç automàtic a incidències i còpia de l'ordre `git commit -m` amb un clic
Com utilitzar-ho
- 1
Selecciona el tipus de commit (p. ex., `feat` per a noves funcionalitats, `fix` per a correccions d'errors).
- 2
Indica un abast opcional (p. ex., `api`, `auth`) i una descripció imperativa concisa.
- 3
Revisa la cadena del commit generada i copia l'ordre completa `git commit` per al teu terminal.
Casos d’ús habituals
- → Adopció d'estàndards coherents d'historial de commits de Git en equips d'enginyeria
- → Automatització d'increments de versions semàntiques i notes de llançament automatitzades en canonades de CI/CD
- → Identificació de canvis incompatibles de l'API (breaking changes) durant actualitzacions majors de biblioteques
Eines relacionades
Generador d'etiquetes Meta SEO
Genera metadades HTML completes: Open Graph, Twitter Cards, robots i metadades estàndard.
Generador de .gitignore
Crea plantilles de fitxers .gitignore per a múltiples llenguatges de programació i entorns de desenvolupament.
Generador de llicències de programari
Genera textos de llicències de codi obert comunes (MIT, Apache 2.0, GPL v3, BSD) amb dades personalitzades.
Generador de README.md
Crea documents README d'aspecte professional per a projectes de GitHub amb insígnies i seccions estàndard.
Calculadora de SemVer (Versionament semàntic)
Valida, compara i incrementa versions segons l'especificació SemVer 2.0.0.
Visor d'especificacions OpenAPI / Swagger
Renderitza i explora documents de documentació d'API Swagger/OpenAPI en formats YAML i JSON.
Preguntes freqüents i privadesa
Quin increment de versió semàntica correspon a cada tipus de commit?
Segons les convencions estàndard de Conventional Commits, `fix` activa un increment PATCH, `feat` activa un increment MINOR i qualsevol commit amb `BREAKING CHANGE` activa un increment MAJOR.
La línia d'assumpte hauria d'acabar amb un punt final?
No. Les bones pràctiques de Conventional Commits recomanen una frase imperativa concisa sense punt final (p. ex., `feat: allow user avatar upload`).