La primera versión de gitmoji es de 2020. Desde entonces se han liberado nuevas versiones de esta propuesta para registrar los mensajes commit en Git usando emojis.

El uso de emojis (que no emoticonos) es muy visual permitiendo identificar fácilmente el propósito o la intención de un cambio. Al haber muchos emojis diferentes, gitmoji proporciona una guía para ayudar a elegir el más apropiado. Usa este patrón:

<propósito> [ámbito opcional:] mensaje
«LÍNEA EN BLANCO»
Cuerpo opcional
«LÍNEA EN BLANCO»
Nota(s) al pie opcional(es)

La primera línea es obligatoria y no debería exceder los 50 caracteres. El resto no deberá tener más de 72 caracteres por línea. Y no olvides que las líneas en blanco deben respetarse si se incluyen dos o los tres apartados de la plantilla.

<propósito> [ámbito opcional:] mensaje

Donde:

• propósito: sería un emoji de la lista.
• ámbito: un texto opcional entre corchetes para añadir información sobre el alcance del cambio. Por ejemplo puedes indicar el nombre de la característica a la que afecta el commit, como core, elements, forms, http, server, etc…
• mensaje: explicando brevemente el cambio, con la primera letra en mayúscula y sin escribir punto al final. Evita las generalidades o descripciones fuera de contexto. Y si te cuesta trabajo resumir, quizás estás aplicando demasiados cambios a la vez.

Cuerpo opcional

• Omite el Cuerpo (Body) si el resumen es suficiente para explicar el contenido y el contexto.
• Mantén el tono imperativo. Puedes usar varias frases y crear listas con guiones o asteriscos. Las frases terminan con punto.
• Debes explicar el qué y el por qué, en lugar de el cómo; para que futuros colaboradores entiendan las razones de haber escogido una solución frente a otras.

Nota(s) al pie opcional(es)

• El Pie (Footer) es opcional.
• Es útil para enumerar las peticiones cerradas o afectadas por el cambio (separadas por coma si son más de una).