Как повысить читабельность технического текста?

Несколько советов, как повысить читабельность технического текста:

• Добавить краткое описание. habr.com Это поможет подавать информацию от общего к частному и облегчит понимание текста. habr.com
• Добавить заголовки и подзаголовки. habr.com vc.ru Они упростят ориентирование по тексту и создадут ощущение порядка. habr.com
• Перевести на язык читателя. habr.com Если в тексте есть прямая речь заказчика с его терминами и оборотами, стоит рассказать, что эти слова значат применительно к системе. habr.com
• Убрать лишнее описание текущей функциональности. habr.com Логично упоминать только то, что затрагивается новой функциональностью или влияет на её разработку. habr.com
• Использовать простые обороты. habr.com Если предложение получается чересчур официальным, стоит попробовать пересказать его по памяти своими словами — так пересказ будет проще. habr.com
• Прочитать текст вслух. e-mba.ru Это поможет выявить шероховатости и неточности. e-mba.ru
• Обратить внимание на размер шрифта и межстрочный интервал. e-mba.ru Стоит выбирать такой размер шрифта, чтобы в строке помещалось около 10 слов, а расстояние между строками установить в 120–140% от размера шрифта. e-mba.ru