até agora, sobre o tema da 'documentação', minha posição tem sido 'a primeira responsabilidade de um criador é trazer à tona a coisa' -- ou seja, escrever o código; projetar o sistema; criá-lo. minha sensação é que 'documentação' como a conhecemos no inferno corporativo de 'gestão do conhecimento' e 'integração' e toda essa bobagem, é realmente algo diferente; e que a primeira coisa que um usuário pós-inicialização de um sistema deve fazer é 'se adaptar' através do mesmo processo que o criador: ou seja, descobrir as propriedades do sistema por conta própria, através de brincadeiras, experimentos ou o que for; e que isso é uma parte vital do processo de aprendizagem. dito isso, é claramente um grande pedido esperar que alguém vá de zero a Herzog em 3 meses. especialmente se não tiver o mesmo nível de obsessão que eu! então a questão permanece em aberto. acho que a resposta é provavelmente alguma forma de documentação 'esqueleto' para impedir que as pessoas sigam caminhos sem saída, mas não para dizer o que fazer; e então forçá-las a aprender brincando com o sistema; com a recompensa de descobrir coisas por conta própria.