На данный момент, по теме 'документации', моя позиция такова: 'первая ответственность создателя — это создать вещь' — то есть написать код; спроектировать систему; создать её. Я считаю, что 'документация', как мы её знаем в корпоративном аду 'управления знаниями' и 'вводе в должность' и всей этой ерунде, на самом деле является чем-то другим; и что первое, что должен сделать пользователь системы после инициализации, — это 'войти в курс дела' через тот же процесс, что и создатель: а именно, открывать свойства системы самостоятельно, через игру, эксперименты или что-то подобное; и что это является жизненно важной частью процесса обучения. Сказав это, очевидно, что это огромная просьба ожидать, что кто-то сможет пройти путь от нуля до Герцога за 3 месяца. Особенно если у них нет такого же уровня одержимости, как у меня! Так что вопрос остается открытым. Я думаю, что ответ, вероятно, заключается в какой-то форме 'скелетной' документации, чтобы не дать людям заблудиться, но не указывать им, что делать; а затем заставить их учиться, играя с системой; с вознаграждением за открытие чего-то нового самостоятельно.