Lección 11 de 12 · Lectura y práctica
Convenciones: commits y PRs consistentes
Convenciones Convenciones reducen friccion. No son burocracia: son UX para equipos. Conceptos clave feat/fix/docs/chore Scopes opcionales Titulos cortos, descripcion util Ejemplo feat(blog): agrega posts y rss fix(seo): incluye.
Del concepto a la práctica
Taller de esta lección
Una convención convierte el historial en datos filtrables. El tipo describe la intención (feat, fix, docs, chore); el alcance opcional acota el área. La convención no reemplaza el cuerpo del commit cuando el motivo o la limitación necesitan explicación.
Ejemplo resuelto
Tres cambios de un catálogo se normalizan así:
feat(catalogo): añade filtro por categoria
fix(precio): evita sumar cursos archivados
docs(readme): explica comando de pruebasCada título usa verbo, área y resultado. Un PR relacionado puede titularse fix(catalogo): conserva categorias vacias y repetir el mismo vocabulario.
Pruébalo
Reúne tres mensajes ambiguos de una práctica.
Clasifica cada cambio por intención.
Añade alcance solo si identifica un área real.
Comprueba que título y diff describen lo mismo.
Error frecuente: usar update para todo. Corrección: reemplázalo por el tipo que explique qué cambió y reserva el cuerpo para el porqué.
Comprueba tu resultado
Los tres mensajes deben tener formato consistente, referir cambios distintos y permitir filtrar todos los commits de documentación con git log --grep='^docs'.

Mapa de prácticaLos cambios se preparan en una rama y se registran en commits pequeños. Las pruebas y la revisión del pull request comprueban el cambio antes de integrarlo. El historial permite entender qué se modificó y recuperar una versión anterior.
Ver la infografía en tamaño completo ↗Fuentes para profundizar
Convenciones
Convenciones reducen friccion. No son burocracia: son UX para equipos.
Conceptos clave
- feat/fix/docs/chore
- Scopes opcionales
- Titulos cortos, descripcion util
Ejemplo
feat(blog): agrega posts y rss
fix(seo): incluye /blog en sitemap
chore(seed): agrega cursos publicos
Ejercicio
- Re-escribe 3 commits tuyos con mensajes mejores.
- Crea un PR con titulo y descripcion consistentes.
Checklist de mastery
- Mis mensajes son consistentes.
- Mis PRs tienen contexto y pasos.
Sigue con Git y GitHub Pro
Esta lección forma parte de un curso de Cursalo. Revisa su programa y elige entre la compra individual o el acceso a toda la escuela.
Si ya tenías acceso a este curso, entra con tu cuenta: tus derechos y tu progreso se conservan. No necesitas comprarlo de nuevo.