Los mensajes de confirmación (commits) son una parte esencial del flujo de trabajo en Git. Un buen mensaje de confirmación no solo describe lo que se ha cambiado, sino también el porqué y el cómo. Esto facilita la colaboración y el mantenimiento del código a largo plazo. En esta sección, aprenderás cómo escribir mensajes de confirmación efectivos y claros.

1. Claridad y Contexto: Proporcionan una descripción clara de los cambios realizados.
2. Historial Legible: Facilitan la navegación y comprensión del historial de cambios.
3. Colaboración: Ayudan a otros desarrolladores a entender las modificaciones sin necesidad de revisar el código en detalle.
4. Depuración: Facilitan la identificación de cambios específicos cuando se busca la causa de un problema.

Un buen mensaje de confirmación generalmente sigue una estructura estándar:

1. Línea de Asunto (Subject Line):

   • Breve y concisa (máximo 50 caracteres).
   • En tiempo presente e imperativo (e.g., "Añade función de búsqueda").
   • Describe el cambio de manera clara.

2. Cuerpo del Mensaje (Opcional):

   • Explicación detallada del cambio (máximo 72 caracteres por línea).
   • Incluye el motivo del cambio y cualquier contexto adicional.
   • Describe cómo se ha solucionado un problema, si aplica.

1. Sé Claro y Conciso: Evita la ambigüedad y sé directo al punto.
2. Usa el Tiempo Presente e Imperativo: Esto ayuda a mantener un estilo consistente y profesional.
3. Incluye el Porqué y el Cómo: No solo describas el cambio, sino también el motivo y el método.
4. Evita Mensajes Genéricos: Mensajes como "arreglos" o "cambios" no son útiles.
5. Divide los Cambios en Confirmaciones Pequeñas: Es mejor tener varias confirmaciones pequeñas y bien descritas que una grande y vaga.

Instrucciones: Imagina que has corregido un error en la función de inicio de sesión de una aplicación web. Escribe un mensaje de confirmación adecuado.

Solución:

Instrucciones: Mejora el siguiente mensaje de confirmación para que sea más claro y útil.

Mensaje Original:

Solución:

Escribir buenos mensajes de confirmación es una habilidad crucial para cualquier desarrollador que utilice Git. Un buen mensaje de confirmación debe ser claro, conciso y proporcionar suficiente contexto para que otros desarrolladores puedan entender los cambios realizados. Siguiendo las mejores prácticas y estructurando tus mensajes de manera adecuada, mejorarás la calidad del historial de tu proyecto y facilitarás la colaboración y el mantenimiento del código.

En la próxima sección, exploraremos cómo mantener un historial limpio en Git, lo que complementará tus habilidades para escribir buenos mensajes de confirmación.