Documentación viva en sistemas legados

La documentation viva, que proviene desde la comunidad de behavior-driven development (BDD), es frecuentemente considerada un privilegio aplicable para aquellas bases de código que incluyen especificaciones ejecutables. Nosotros encontramos que esta técnica puede ser aplicada también a sistemas legados. La falta de conocimiento de negocio es un obstáculo común que encuentran los equipos cuando están realizando modernización de los sistemas. El código es usualmente la única fuente confiable de verdad debido a las rotaciones de personal y la falta de actualización de la documentación existente. Por lo tanto, es muy importante restablecer la asociación entre la documentación y el código y esparcir el conocimiento del negocio en el equipo cuando se toma a cargo un sistema legado. En práctica, podríamos primero acudir al código y profundizar nuestro conocimiento del negocio simplemente a través de una limpieza o refactorización segura del mismo. Durante el proceso, necesitaremos agregar anotaciones al código para ser capaces de generar automáticamente documentación viva más tarde. Esto es muy diferente a hacer BDD en proyectos green-field, pero es un buen inicio en sistemas legados. Basados en la documentación generada podríamos tratar de convertir algunas de las especificaciones en pruebas de automatización ejecutables de alto nivel. Haz esto iterativamente y eventualmente puedes obtener una documentación viva en sistemas legados que está estrechamente asociada con el código y es parcialmente ejecutable.