📝 Buen commit vs. Mal commit: Mejora tu árbol de Git

¿Te ha pasado que vuelves a un proyecto después de meses y encuentras un commit llamado "arreglar cosas"? 😬 Sí, a todos nos ha pasado. ¡Pero no tiene que ser así! Hoy quiero hablarte de la importancia de escribir buenos commits y cómo pueden hacer tu vida (y la de tu equipo) mucho más fácil.

🤔 ¿Por qué importa un buen commit?

Un commit no es solo un "guardar partida" en tu código; es como una entrada en el diario de tu proyecto. Describe qué hiciste, por qué lo hiciste y, si es necesario, cómo lo hiciste. Los commits bien escritos:

✅ Facilitan entender el historial del proyecto.
✅ Ayudan a resolver bugs más rápido.
✅ Mejoran la colaboración en equipo.

Y lo más importante: te hacen ver como un profesional que sabe lo que hace. 😎

🚨 Ejemplo de mal commit

git commit -m "cambios"

¿Cambios de qué? ¿Arreglaste algo? ¿Agregaste una funcionalidad? ¿Borraste medio repositorio? Nadie lo sabe. Ni siquiera tú lo sabrás en dos semanas. 😅

Otro clásico:

git commit -m "arreglo bug"

Bien por arreglar el bug, pero... ¿qué bug? ¿En qué parte? Sin contexto, no sirve de mucho.

💡 Ejemplo de buen commit

git commit -m "fix: corregir validación de emails en el formulario de registro"

🔍 Ahora sabemos exactamente qué se hizo y dónde. Si el bug regresa o surge algo relacionado, este commit será una brújula para encontrar la solución.

Otro ejemplo para nuevas funcionalidades:

git commit -m "feat: agregar funcionalidad para compartir enlaces en redes sociales"

Esto no solo dice qué se hizo, sino que usa un convención estándar como Conventional Commits.

🎯 Tips para buenos commits

Usa una convención clara:

• feat: para nuevas funcionalidades.
• fix: para correcciones de bugs.
• refactor: para mejorar código sin cambiar funcionalidad.
• docs: para cambios en documentación.

Escribe mensajes descriptivos y precisos:
Un buen commit responde a estas preguntas:

¿Qué cambiaste?
¿Por qué lo cambiaste?
Haz commits pequeños y específicos:
No mezcles una nueva funcionalidad con arreglos de bugs en el mismo commit. Divide y vencerás.

Incluye contexto si es necesario:
Si estás corrigiendo un bug complicado, puedes usar el mensaje extendido:

git commit -m "fix: corregir error de autenticación al usar OAuth" -m "El error ocurría porque el token expiraba antes de ser validado. Se implementó una lógica para manejar tokens expirados."  

🛠️ Herramientas útiles

Si quieres automatizar o mantener consistencia:

• Commitizen: Guía para escribir mensajes siguiendo convenciones.
• Husky: Ejecuta hooks de Git para validar commits.

🚀 ¡Haz que tus commits hablen por ti!

Un buen mensaje de commit no solo ayuda a tus compañeros de equipo, sino también a tu yo del futuro. Escribir buenos commits es una inversión pequeña con un gran retorno en claridad y productividad.

¿Tienes algún truco o convención que uses para tus commits? ¡Déjamelo en los comentarios! 👇