GuíaIntermedio

Guía de Clean Code y Code Review

Aprende a escribir código que otra persona pueda leer sin sufrir, y a participar en una revisión como profesional en las dos sillas: la de quien propone —empaquetar un cambio, escribir el pull request que lo explica y defender tus decisiones sin ponerte a la defensiva— y la de quien revisa —saber qué mirar primero, qué comentar y qué dejar pasar, y cómo decir lo que ves sin que el otro se cierre. No sales con una lista de reglas de estilo memorizadas: sales sabiendo por qué cada regla existe, cuándo romperla y cómo se conversa sobre código con gente que no piensa igual que tú. Los ocho módulos giran alrededor de Cardumen, una startup de 14 personas con una cultura de revisión rota —PRs que se aprueban en dos minutos con un "LGTM", revisiones temidas, gente que dejó de proponer cambios grandes— y avanzan de código legible a señales de que algo se pudre, al cambio como unidad de comunicación, a revisar el código de otra persona, a la conversación difícil, a estándares que el equipo sí sigue, a revisar código escrito por IA, y cierran con el arco completo de un día real de trabajo.

64
lecciones
8
módulos
Inglés · Español
disponible en
certificado
Gratis
acceso
NIEVA

Resultados

Lo que vas a poder hacer

  • Escribir código que otra persona pueda leer sin sufrir: nombres que no necesitan explicación, funciones que caben en la cabeza, comentarios que explican el porqué y nunca el qué
  • Reconocer las señales de que el código se está pudriendo —duplicación, funciones que hacen demasiado, anidamiento profundo, manejo de errores que esconde el error— y nombrar la deuda técnica en vez de sufrirla en silencio
  • Empaquetar un cambio como una unidad de comunicación: una sola intención, del tamaño correcto, con mensajes de commit y una descripción de PR que dan contexto, decisión y riesgo
  • Revisar el código de otra persona con un orden explícito —intención, diseño, detalle— y marcar cada comentario como bloqueo, sugerencia u opinión
  • Revisar los tests y lo que no está en el diff —seguridad, casos borde, datos—, no solo el código visible
  • Sostener la conversación difícil: defender una decisión sin ponerte a la defensiva, reconocer cuándo el revisor tiene razón, y discrepar y comprometerte cuando no hay bloqueo real
  • Acordar con tu equipo estándares que sí se siguen: automatizar lo automatizable, una guía de estilo mínima viable y checklists de revisión que no estorban
  • Revisar código escrito por IA con un criterio distinto: verificar en vez de confiar, detectar código plausible que no funciona, y responder por la autoría de lo que subes
  • Cerrar el arco completo en un mismo día: proponer, recibir una revisión dura, revisar bajo presión de tiempo, y diagnosticar y arreglar una cultura de revisión rota

Antes de empezar

Qué necesitas traer

Es para ti si...

  • Devs que ya programan y han trabajado sobre código compartido, aunque sea poco: un repositorio con otra persona, un equipo, una contribución externa
  • Quien recibe revisiones que se sienten personales, o da revisiones que el equipo teme
  • Equipos con una cultura de revisión rota: PRs que se aprueban en dos minutos con un "LGTM", o que se quedan días sin revisar
  • Devs que empiezan a recibir más código generado por IA del que pueden revisar a fondo, y necesitan un criterio distinto para eso

Requisitos y materiales

  • Saber programar y haber trabajado sobre código compartido, aunque sea poco
  • Ideal, no obligatorio, haber visto una guía de fundamentos de desarrollo de software y una de patrones de diseño
  • Los ejemplos usan Python con identificadores en inglés, pero todo lo enseñado aplica a cualquier lenguaje

Contenido

El temario, módulo por módulo

Abre cualquiera para ver sus lecciones.

Dudas frecuentes

Lo que suele preguntarse

Empieza cuando quieras

Reseñas

Lo que dicen los estudiantes

Estas reseñas son de estudiantes inscritos que completaron al menos el 50% del curso. Moderamos las reseñas solo por motivos de contenido (spam, lenguaje ofensivo, datos personales), nunca por ser críticas o negativas.

Aún no hay reseñas aprobadas.

¡Sé el primero en compartir tu experiencia!