Buenas prácticas pro: convenciones, seguridad y recuperación

Define reglas de equipo para ramas, commits, PRs y secretos; aprende estrategias de recuperación cuando algo se rompe.

Un equipo rápido no es el que comete menos errores, sino el que los detecta y recupera antes gracias a reglas claras.

Las mejores prácticas en Git/GitHub combinan convención, automatización y seguridad: naming de ramas, protección de main, CI obligatoria y cero secretos en repos.

Si vas a desplegar desde repositorio, enlaza estas prácticas con <a href="/curso/hosting-dominios">el curso de Hosting y Dominios</a> para cerrar el flujo end-to-end.

  • Pocas reglas, pero bien aplicadas siempre.
  • Define una convención de commits (por ejemplo, Conventional Commits), naming de ramas y template de PR. Esto reduce ambigüedad y acelera revisiones.
  • Configura ramas protegidas para impedir pushes directos a main y exigir checks de CI + revisión antes de merge.
  • Ramas: feature/, fix/, chore/.
  • Commits con intención clara.

Reglas mínimas de equipo que marcan diferencia

Pocas reglas, pero bien aplicadas siempre.

Define una convención de commits (por ejemplo, Conventional Commits), naming de ramas y template de PR. Esto reduce ambigüedad y acelera revisiones.

Configura ramas protegidas para impedir pushes directos a main y exigir checks de CI + revisión antes de merge.

  • Ramas: feature/, fix/, chore/.
  • Commits con intención clara.
  • PR con contexto, pruebas y alcance.
  • Main protegida y sin merges sin revisión.

Seguridad y recuperación ante incidentes

Asume que algún día te equivocarás y prepara red de seguridad.

Nunca subas claves o tokens al repositorio. Usa variables de entorno y herramientas de escaneo de secretos. Si se filtra un secreto, revócalo inmediatamente.

Para recuperación rápida: usa tags en releases, ramas de hotfix y un protocolo claro de rollback. Una crisis sin protocolo cuesta horas; con protocolo, minutos.

Git & GitHub
14

Buenas prácticas pro: convenciones, seguridad y recuperación

Define reglas de equipo para ramas, commits, PRs y secretos; aprende estrategias de recuperación cuando algo se rompe.

Código del tema: Comandos reproducibles y trazables

📘 Teoría

Reglas mínimas de equipo que marcan diferencia

Pocas reglas, pero bien aplicadas siempre.

Define una convención de commits (por ejemplo, Conventional Commits), naming de ramas y template de PR. Esto reduce ambigüedad y acelera revisiones.

Configura ramas protegidas para impedir pushes directos a main y exigir checks de CI + revisión antes de merge.

  • Ramas: feature/, fix/, chore/.
  • Commits con intención clara.
  • PR con contexto, pruebas y alcance.
  • Main protegida y sin merges sin revisión.

Seguridad y recuperación ante incidentes

Asume que algún día te equivocarás y prepara red de seguridad.

1

Nunca subas claves o tokens al repositorio. Usa variables de entorno y herramientas de escaneo de secretos. Si se filtra un secreto, revócalo inmediatamente.

2

Para recuperación rápida: usa tags en releases, ramas de hotfix y un protocolo claro de rollback. Una crisis sin protocolo cuesta horas; con protocolo, minutos.

Chequeos básicos antes de push
git status
git diff --staged
git log --oneline -n 3

🧭 Visuales clave

Protección ante secretos antes de que lleguen al repositorio

Encaja con la sección de seguridad porque hace visible una de las barreras más útiles para evitar fugas de credenciales.

Ejemplo visual de protección de push frente a secretos expuestos para reforzar buenas prácticas de seguridad

README con enlaces y contexto útil

Refuerza la idea de que una convención de equipo también incluye documentación clara y accionable, no solo commits y ramas.

Captura de un README con enlaces bien estructurados para ilustrar documentación mínima útil en un repositorio

🧪 Aprende probando

Ejemplo Ejemplo guiado: commit con convención Practica un commit estilo Conventional Commits.
Ejemplo Ejemplo guiado: auditoría rápida antes de push Comprueba estado, diff staged e historial inmediato.
Ejemplo Demo: ritual de 60 segundos antes de PR Mini protocolo para reducir revisiones fallidas.

🏁 Retos

Reto Reto: commit de corrección bien nombrado Escribe un commit con prefijo fix y scope.
Reto Reto: inspeccionar historial con grafo Muestra ramas y merges en formato compacto.

🧰 Recursos

¿Qué es esto?

Soy Cristian Eslava y a veces hago webs para procrastinar yo y vosotros 😉.

Esta la hice en febrero de 2026 para facilitar el aprendizaje de mis alumnxs. Aprender desarrollo web practicando. La idea es que crezca semanalmente con nuevos temas, tests y retos.

Inspirado en MDN, en W3Schools, en Codepen, en el crack de Manz y en mil sitios de documentación sobre desarrollo web. Quería aportar además de bloques teóricos con ejemplos, la gamificación de los retos y el sistema de test que ya tenía en culTest .

Si te gustó, si no te gustó, si quieres saludarme, o invitarme a 🍻 no dudes en escribirme en cristianeslava@gmail.com .