Agustín Ventura (@agustinventura.bsky.social)

¿No sabes muy bien qué hace tu aplicación? Nos pasa a todos. Los tickets de Jira o los documentos de requisitos se quedan obsoletos. Pero ¿y si tu documentación fuera ejecutable y verificable? De eso hablo en este post: https://go.agustinventura.dev/cucumber-living-docs 🧵👇

loading . . .

De la Historia de Usuario a la Documentación Viva con Cucumber | Agustín Ventura Ya hemos visto en otro post mi propuesta para tener una documentación ligera del proyecto que se mantenga actualizada y sea realmente útil (spoiler: reduciéndola al máximo), sin embargo era documentación más bien técnica, dirigida al equipo o a posibles colaboradores. Es cierto que tenemos un README en el que especificamos que hace la aplicación (o servicio o como queramos decirle), pero… ¿cómo podemos mantener viva la documentación sobre QUÉ es lo que hace el proyecto detalladamente? ¿No sería genial si esta documentación fuera ejecutable y verificable? De esa manera nos podríamos asegurar siempre de que no rompemos nada y que la funcionalidad más importante de la aplicación sigue funcionando. De la misma manera que para la documentación técnica trato de mantener un enfoque práctico y minimalista, creo que para esta documentación de funcionalidad (o comportamiento) debemos hacer lo mismo. Cuántos más artefactos superfluos tengamos (larguísimos documentos de requisitos, especificaciones de usuarios…) peor, mayor sería la entropía acumulada. Entonces, ¿cómo podemos recoger esta información? Una aproximación son las historias de usuario. https://go.agustinventura.dev/cucumber-living-docs