hasta ahora, sobre el tema de 'documentación', mi postura ha sido 'la primera responsabilidad de un creador es traer a la vida la cosa' -- es decir, escribir el código; diseñar el sistema; crearlo. Mi sensación es que 'documentación' tal como la conocemos en el infierno corporativo de 'gestión del conocimiento' y 'onboarding' y toda esa tontería, es realmente algo diferente; y que lo primero que un usuario post-inicialización de un sistema debería hacer es 'acostumbrarse' a través del mismo proceso que el creador: a saber, descubrir las propiedades del sistema por sí mismos, a través del juego, la experimentación o lo que sea; y que esto es una parte vital del proceso de aprendizaje. Dicho esto, claramente es una gran exigencia esperar que alguien pase de cero a Herzog en 3 meses. Especialmente si no tienen el mismo nivel de obsesión que yo! Así que la pregunta sigue siendo abierta. Creo que la respuesta es probablemente alguna forma de documentación 'esquelética' para evitar que la gente se pierda en callejones sin salida, pero no para decirles qué hacer; y luego forzarlos a aprender jugando con el sistema; con la recompensa de descubrir cosas por sí mismos.