Hasta ahora, sobre el tema de la 'documentación', mi postura ha sido 'la primera responsabilidad de un creador es sacar a la luz la cosa', es decir, escribir el código; diseñar el sistema; créalo. Mi sensación es que la "documentación" tal como la conocemos en el infierno del esqueleto corporativo de la "gestión del conocimiento" y la "incorporación" y todas esas tonterías, es realmente algo diferente; y que lo primero que debe hacer un usuario posterior a la inicialización de un sistema es "acelerar" a través del mismo proceso que el creador: es decir, descubrir las propiedades del sistema por sí mismo, a través del juego, el experimento o lo que sea; y que esta es una parte vital del proceso de aprendizaje. dicho esto, es claramente una gran petición 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 abierta. Creo que la respuesta es probablemente algún tipo de documentación "esquelética" para evitar que la gente caiga en callejones sin salida, pero no para decirles qué hacer; y luego obligarlos a aprender jugando con el sistema; con la recompensa de descubrir cosas por sí mismos.
6.81K