Cada mensaje de commit comienza con el tipo, seguido de un ambito, luego un asunto.
Y finalmente, el mensaje de commit tiene un cuerpo.
- tipo: Que tipo de cambio contiene este commit.
- ambito: Que ítem del código está cambiando con este commit.
- asunto: Una descripción corta de los cambios realizados en este commit.
- cuerpo (opcional): Una descripción más detallada de los cambios.
<tipo>(<ambito>): <asunto>
<Línea en blanco>
<cuerpo>
Ejemplos:
feat(regla): use graphite instead of lead
fix(protractor): fix 90 degrees counting as 91 degrees
refactor(pencil): use graphite instead of lead
Closes #640.
Graphite is a much more available resource than lead, so we use it to lower the price.
fix(pen): use blue ink instead of red ink
BREAKING CHANGE: Pen now uses blue ink instead of red.
To migrate, change your code from the following:
`pen.draw('blue')`
To:
`pen.draw('red')`
Cualquier línea del mensaje de commit no debe tener más de 100 caracteres. Esto permite que el mensaje de commit sea más fácil de leer en github, así como en diferentes herramientas de Git.
Se recomienda usar uno de los siguientes ítems. Solo los de tipo feat y fix aparecerán en la lista de cambios(changelog), in addition to breaking changes (see breaking changes section at bottom).
- feat: Una nueva característica.
- fix: Una corrección de error.
- docs: Cambios en la documentación o en los comentarios(notar que el tipo es en plural 'docs').
- style: Cambios que no afectan el significado del código (espacios en blanco, formateo, faltó un punto y coma, etc).
- refactor: Un cambio en el código que no corrige un error, ni agrega una característica.
- test: Agregando pruebas que falten(porque agregar nuevos test son considerados feat).
- chore: Cambios en el proceso de construcción(compilación) o herramientas auxiliares y/o bibliotecas como generadores de documentación.
- wip: (Work in Progress). Este tipo de commit se usará cuando necesitemos commitear el trabajo que hayamos avanzado y por algun motivo nos encontremos en la necesidad de subirlo.
Se refiere al ámbito dentro de la aplicación. Exactamente donde se realiza el cambio.
Por ejemplo suscriptor,
registro, login, etc...
El asunto contiene la descripción corta del cambio:
- Se recomienda usar palabras en tiempo presente: "cambio" no "cambiado"
- No Capitalizar la primera letra, usar solo minúsculas
- No usar punto(.) al final