Até agora, sobre o tema da 'documentação', minha posição tem sido 'a primeira responsabilidade de um criador é trazer a coisa' - isto é, escrever o código; projetar o sistema; criá-lo. Meu sentimento é que a 'documentação' como a conhecemos no inferno do esqueleto corporativo de 'gestão do conhecimento' e 'integração' e todo esse absurdo, é realmente algo diferente; e que a primeira coisa que um usuário pós-inicialização de um sistema deve fazer é 'acelerar' pelo mesmo processo que o criador: ou seja, descobrir as propriedades do sistema por si mesmo, por meio de brincadeiras, experimentos ou qualquer outra coisa; e que esta é uma parte vital do processo de aprendizagem. dito isto, é claramente uma grande pergunta esperar que alguém vá de zero a Herzog em 3 meses. especialmente se eles não tiverem o mesmo nível de obsessão que eu! Portanto, a questão permanece em aberto. Acho que a resposta é provavelmente alguma forma de documentação 'esqueleto' para impedir que as pessoas caiam em becos sem saída, mas não para dizer a elas o que fazer; e então forçá-los a aprender brincando com o sistema; com a recompensa de descobrir coisas por si mesmas.