Почему документацию не читают

Проблема редко в том, что написано. Чаще — в том, как это написано. Длинные предложения, сложные слова и технический жаргон делают текст утомительным ещё до того, как читатель вникает в смысл.

Чтобы не оценивать понятность «на глаз», используют метрики удобочитаемости — например, индекс Флеша и Флеша–Кинкейда. Они показывают, сколько усилий требуется для чтения текста, анализируя длину предложений и слов.

Метрики не понимают смысл и не заменяют редактора. Но они хорошо находят перегруженные места и помогают сделать текст проще и понятнее — особенно в технической документации.

Если текст сложно читать, его просто не будут читать. В статье разбираем, как работают метрики удобочитаемости и как применять их для русскоязычных текстов.