¿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! 👇
Top comments (0)