La mejor prueba de tu ingeniería es lo que sucede cuando te alejas. Si alguien tiene que escribirte "¿cómo funciona esto?" — has fallado. Los sistemas deberían seguir funcionando. Los pipelines deberían seguir desplegando. Los dashboards deberían seguir actualizándose.
Esta es la parte más intencional de mi práctica de ingeniería: construir para la persona que viene después de mí.
La Prueba
Antes de considerar que cualquier sistema está "terminado", pregunto: "¿Podría un ingeniero de nivel medio, que nunca ha visto este código, operarlo sin contactarme?"
Si la respuesta es no, no he terminado. El código puede funcionar, pero no está completo.
Cómo se Ve la "Operabilidad"
1. README Que Responde las Primeras 5 Preguntas
Cada nuevo ingeniero hace las mismas 5 preguntas:
- ¿Qué hace esto?
- ¿Cómo lo ejecuto localmente?
- ¿Cómo lo despliego?
- ¿Dónde están los logs?
- ¿A quién contacto si se rompe?
\\
