Cómo escribir «buen código heredado»
Aquí hay algunos puntos de partida rápidos para escribir buen código heredado. El código es mucho más fácil de escribir que de leer, y la mejor manera de solucionar los problemas es no crearlos.
Escribir menos código
Menos código = menos potencial de errores = menos que mantener = menos «mal legado».
Escribir menos código podría considerarse la forma más importante de mejorar el código en general. El principio DRY puede ser visto como un corolario natural y un medio primario para escribir menos y lograr más.
Evitar // TODO y // FIXME
Escribir // TODO o // FIXME debe ser visto como una bandera roja y un olor a código.
Si traducimos estos comentarios a sus significados reales entonces «TODO» se traduce como «crear deuda técnica» y «FIXME» se traduce como «estoy escribiendo intencionalmente un error».
Puede haber raras excepciones en las que aplazar una solución supere los beneficios de resolverla ahora, pero en general, TODO y FIXME deben mantenerse al mínimo.
Preferir modismos establecidos sobre la vanguardia
Esto puede parecer contradictorio… usar tecnologías de vanguardia hace que el código sea más «nuevo», ¿verdad? Bueno, sí, pero también crea la posibilidad de quedar desfasado más rápidamente.
También hace que los nuevos programadores tengan más dificultades para entender las cosas. Si el código está escrito utilizando modismos y marcos de trabajo establecidos, es probable que sea más fácil de leer y tiene una mejor oportunidad de trabajar más tiempo en el futuro.
Siempre deje el código en un mejor estado del que lo encontró
Esto podría parecer que contradice el «no reescribir» mencionado al principio, sin embargo, la mejora continua y la refactorización es diferente de hacer una reescritura significativa.
Trate de adquirir el hábito de mejorar las cosas gradual e incrementalmente. A veces una gran refactorización o reescritura es realmente necesaria, pero el valor de negocio de esto debe ser cuidadosamente sopesado frente a otras prioridades.
Sigue mejorando como programador
Lee libros, lee entradas de blog, lee el código de otras personas, piensa cuidadosamente sobre el diseño y las prácticas de programación. Reflexiona conscientemente sobre tu código y piensa en formas de mejorar.
En lugar de culpar al programador anterior por dejar un mal legado, asegúrate de no convertirte en el programador que crea uno nuevo.