Saltar al contenido

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í:

text
feat(catalogo): añade filtro por categoria
fix(precio): evita sumar cursos archivados
docs(readme): explica comando de pruebas

Cada título usa verbo, área y resultado. Un PR relacionado puede titularse fix(catalogo): conserva categorias vacias y repetir el mismo vocabulario.

Pruébalo

  1. Reúne tres mensajes ambiguos de una práctica.

  2. Clasifica cada cambio por intención.

  3. Añade alcance solo si identifica un área real.

  4. 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'.

Rama de trabajo con commits, pruebas y revisión antes de integrarla en la rama principal.
CursaloMapa de práctica
Cambios pequeños, revisión clara

Los 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.

01 / ELEGIR UNA RUTA

El próximo paso

Aprende IA mientras construyes algo que sí necesitas.

Empieza por el curso inicial o explora el catálogo para encontrar una práctica alineada con tu trabajo.