коллеги, а вы как-то пропускаете, для чего вы делаете документацию.
Кажется, здесь мало тех несчастных, которые тянут лямку «пишем по ГОСТу» и тем самым поддерживают этот безумный дьявольский обряд.
Кто _мерял_ на продакшне, как люди читают? Кто ходит в глоссарий, кто нажимает на раскрытие хелпа и т.п.?
Как можно обсуждать эти вопросы без цифр кликов?
Мне довелось поработать с базой знаний, которую отдел поддержки (колл-центр, это всё) разрабатывал сам для себя - поддерживал, актуализировал, регулярно проводил внутренние экзамены. Там глоссарий был. Метрики были. Это так, в качестве примера.