No existe una regla obligatoria o universal para redactar los mensajes de commit en Git, pero sí se han establecido convenciones ampliamente aceptadas en la comunidad de desarrollo, especialmente en los países de habla inglesa. Una de las prácticas más recomendadas es escribir el mensaje de commit utilizando el modo imperativo al inicio. Por ejemplo, en lugar de escribir "Agregué la funcionalidad de login", se sugiere redactar "Agrega funcionalidad de login". Esto se debe a que el mensaje de commit debe describir lo que el commit hace, como si fuera un comando, lo cual facilita la lectura del historial de cambios y mantiene la consistencia en el registro de versiones.
Además, es fundamental que el mensaje de commit sea descriptivo y claro, indicando de manera precisa lo que se modificó, agregó o eliminó en el proyecto. Por ejemplo, en vez de un commit vago como "Actualiza archivo", es preferible escribir "Corrige error en la validación del formulario de registro" o "Agrega soporte para autenticación mediante redes sociales". Esto no solo ayuda a otros miembros del equipo a entender rápidamente los cambios, sino que también facilita el mantenimiento y la resolución de problemas en el futuro.
Durante las clases, la instructora Ellen mostró de manera didáctica y sencilla cómo estructurar estos mensajes, pero en un entorno de trabajo real, muchas empresas adoptan una sintaxis o convención estándar para los commits. Algunas de estas convenciones incluyen:
Conventional Commits: Una convención que sugiere un formato específico para los mensajes de commit, incluyendo etiquetas como feat: para nuevas funcionalidades, fix: para correcciones de errores, docs: para cambios en la documentación, etc. Uso de referencias: Incluir en el mensaje el número de ticket o issue relacionado, lo cual mejora la trazabilidad y facilita la colaboración en entornos ágiles. Resumen y detalle: Un mensaje de commit a menudo se compone de un resumen corto (máximo 50-72 caracteres) en la primera línea, seguido de una descripción más detallada en el cuerpo del commit si es necesario. En conclusión, aunque no existe una norma estricta, adoptar un estilo consistente y descriptivo (por ejemplo, usando el imperativo) para los mensajes de commit es una práctica que mejora la colaboración, la claridad y el mantenimiento del código. Cada empresa o equipo puede definir y documentar su propia convención, pero lo importante es que el mensaje cumpla con el objetivo de comunicar de forma efectiva qué cambios se han realizado en cada commit.
