Entendiendo los Conventional Commits: Más que un Estándar, un Salvavidas para Equipos Técnicos

¿Alguna vez abriste el historial de un repositorio y sentiste que descifrar los mensajes de commits es como intentar leer jeroglíficos? Tranquilo, no estás solo. Ahí es donde los Conventional Commits se convierten en héroes. Este estándar propone una solución clara, ordenada y fácil de entender para documentar el trabajo en un proyecto. En este artículo, vamos a desmenuzar qué son, por qué importan y cómo pueden revolucionar tu flujo de trabajo como desarrollador.

¿Qué son los Conventional Commits?

Los Conventional Commits son un conjunto de reglas sencillas para estructurar los mensajes de tus commits. Este estándar surge para responder a una pregunta que todos nos hemos hecho al menos una vez: ¿Cómo puedo hacer que los mensajes sean claros y útiles para todos? La idea es que cada mensaje siga una sintaxis específica que describe el propósito del commit de forma breve y consistente.

La estructura básica de los Conventional Commits

<tipo>[alcance opcional]: <descripción>

• Tipo: Indica el propósito del cambio, como feat (nueva funcionalidad), fix (corrección de errores), entre otros.
• Alcance (opcional): Describe qué parte del código afecta el cambio.
• Descripción: Una explicación breve y clara del cambio.

Por ejemplo:

feat(api): añade endpoint para la gestión de usuarios
fix(ui): corrige el error en el formulario de login

Esta simplicidad permite que tanto el mismo desarrollador como cualquier miembro del equipo puedan entender rápidamente qué hace cada commit.

Podés consultar la especificación formal de Commits Convencionales para tener más info.

¿Por qué deberías usar Conventional Commits?

El estándar no solo está pensado para hacer que el historial de commits sea bonito y ordenado (aunque eso es un gran beneficio). También tiene un impacto práctico que afecta directamente al flujo de trabajo:

• Facilita las revisiones de código: Mensajes claros y bien estructurados ayudan a los revisores a entender el contexto de los cambios sin necesidad de revisar todo el código.
• Automatización al rescate: Los Conventional Commits permiten que herramientas como Semantic Release generen versiones, changelogs y publicaciones automáticamente basándose en los tipos de commits. Por ejemplo, un commit con feat puede disparar un cambio de versión menor (minor), mientras que uno con fix puede iniciar un parche (patch).
• Consistencia en el equipo: En proyectos con múltiples colaboradores, los Conventional Commits unifican la forma en que todos documentan los cambios, eliminando confusiones y malentendidos.

¿Cómo empezar a usar Conventional Commits?

Adoptar este estándar es más sencillo de lo que parece. Aquí te dejo algunos pasos prácticos para implementarlo en tu flujo de trabajo:

1. Aprender la sintaxis: Familiarízate con los tipos más comunes (feat, fix, docs, style, refactor, test, chore).
2. Establecerlo como regla: Comunica al equipo la importancia de usar Conventional Commits y acuerden seguir este estándar.
3. Herramientas útiles:
   • Usa commitlint para validar los mensajes de commit automáticamente.
   • Implementa husky para ejecutar hooks de Git que aseguren que los commits sigan el estándar.
4. Practica y no te frustres: Es normal cometer errores al principio, pero con el tiempo, escribir commits según este estándar se vuelve natural.

Datos curiosos

1. Nació de una necesidad común: Este estándar fue desarrollado como parte de la iniciativa Angular Commit Guidelines, que buscaba solucionar los problemas de inconsistencia en los commits dentro del equipo de Angular.
2. Es clave para el versionado semántico: Si ya usás Semantic Versioning (MAJOR.MINOR.PATCH), los Conventional Commits son su mejor aliado. Es como tener un copiloto que te dice cuándo debes actualizar la versión de tu proyecto.
3. Un estándar “elegante”: Aunque puede parecer rígido al principio, muchos desarrolladores coinciden en que una vez que lo adoptás, trabajar con Conventional Commits es casi terapéutico.

Conclusión: Tu historial de commits nunca fue tan claro

Adoptar los Conventional Commits es más que una buena práctica: es un paso hacia un flujo de trabajo más eficiente y organizado. Además, cuando todo está en orden, el equipo gana en productividad y se evitan discusiones sobre la interpretación de un mensaje de commit como: “¿Qué quiso decir con ‘fix cosas raras’?“_

En Nube Ágil, sabemos que pequeños detalles como este marcan la diferencia entre un proyecto caótico y uno bien gestionado. Si aún no probaste Conventional Commits, ¿qué estás esperando? Probalo en tu próximo proyecto y disfrutá del cambio.

¿Qué opinás de los Conventional Commits? ¿Ya los usás o estás pensando en adoptarlos? Comparte tu experiencia en los comentarios y no olvides suscribirte para más contenido técnico como este.