Вы начали спор интересно конечно. Но главный вопрос это то как составляется документация на что-то.
Чем сложнее и многогранее вопрос тем соответственно сложнее документация. Но это не значит что документация будет написана понятно для всех.
Есть вещи которые крайне трудно формализовать в некие правила. Можно, но тогда эту документацию вы не получите в обозримом будущем.
Хватило уже того что многих обязали уйти от main-slave. Что от этого простого шага, который решается обычной find-replace, получило сообщество - ничего серьезного.
Так и от составления документа как надо писать документацию и в дополнение как ее потом читать будет хуже всем.
Любая книга-документация (ну или почти любая) начинается с введения, также принято снабжать оглавлением и индексом терминов и понятий, для удобного поиска.
Если человек не может читать документацию, то видимо у него недостаточный уровень и стоит изучить базовые вещи начиная со школьного букваря и поднимаясь выше и выше. В некоторых случаях как кода упоминалось есть рекомендации для уровня в освоении книги и их достаточно для освоения книги. Достаточно, но это не значит что материал книги будет усвоен