Mensajes de Commit
Desliza para mostrar el menú
Por qué son importantes los mensajes de commit
Los mensajes de commit son fundamentales para comprender el historial de un proyecto. Mensajes claros y significativos ayudan a colaboradores, desarrolladores futuros y a ti mismo a entender el propósito y el contexto de cada cambio. Un historial de commits bien estructurado mejora la colaboración, simplifica la depuración y facilita el seguimiento de cambios específicos en la línea de tiempo del proyecto.
Anatomía de un buen mensaje de commit
1. Concisión y claridad
Un mensaje de commit debe ser conciso y directo. Debe transmitir claramente el propósito del commit en una sola línea. Evitar la ambigüedad y proporcionar suficiente información para comprender el cambio sin necesidad de revisar el código.
Bad: "Fixed a bug"
Good: "Fix issue with user authentication in login form"
2. Separar el asunto del cuerpo
Si se necesitan más detalles, separar el asunto del cuerpo del mensaje de commit con una línea en blanco. El asunto debe resumir el cambio y el cuerpo puede proporcionar contexto adicional, razones del cambio y cualquier información relevante.
Veamos un ejemplo de este tipo de mensaje de commit:
Subject: "Add validation for user email input"
Body: "This commit introduces email format validation to ensure
that users provide a valid email address when registering. It
helps improve the overall data integrity of the system."
En este caso, ejecutar el comando git commit sin la opción -m:
git commit
Se abrirá el editor de texto predeterminado de Git, donde puedes escribir un mensaje de confirmación detallado. Luego debes guardar y salir correctamente del editor de texto.
Realicemos otro commit en nuestro repositorio:
Aquí está el comando utilizado para modificar el archivo de texto:
echo "Git is the most popular VCS in the world used by millions of developers since it allows efficient collaboration via committing, reverting and merging changes. Besides, Git is free and open source and can be easily installed on Windows, macOS, Linux and all Unix-based platforms." >> test.txt
El mensaje de confirmación es el siguiente:
Subject: "Add description of Git"
Body: "This commit introduces brief description
of Git and highlights its key features. It also
states the reasons for the widespread popularity
of Git."
Si no puedes editar el archivo, presiona la tecla i. Esto asegura que ingreses al modo de edición. Nuevamente, para guardar los cambios y salir de Vim, presiona la tecla Escape y dos letras Z mayúsculas.
Si tienes un editor de texto predeterminado diferente para la terminal (que no sea Vim) y encuentras alguna dificultad, puedes encontrar fácilmente cómo guardar los cambios y salir en internet.
3. Uso del modo imperativo
Escribir mensajes de commit en modo imperativo, lo que proporciona una orientación clara para el cambio. Comenzar el asunto con un verbo, como "Corregir", "Agregar" o "Actualizar".
Bad: "Fixed the issue with the login form"
Good: "Fix issue with user authentication in login form"
¡Gracias por tus comentarios!
Pregunte a AI
Pregunte a AI
Pregunte lo que quiera o pruebe una de las preguntas sugeridas para comenzar nuestra charla