- PVSM.RU - https://www.pvsm.ru -
Не только содержание, но и структура текста должна быть осмысленна.
Так, если мы говорим о техническом или научном тексте, например, о статье или документации, то форма должна помочь максимально быстро и легко понять содержание. Для меня, в случае статьи, это значит, что структура должна быть приблизительно такой:
Конечно, структура не должна обязательно быть именно такой. Например, в зависимости от сложности и длины текста, какие-то разделы могут быть лишними или, наоборот, могут быть добавлены, но структура должна соответствовать цели. В данном случае изложенный подход позволяет читателю понять содержание сложной статьи максимально быстро и с необходимой степенью глубины. Я применил этот подход при написании статьи Нелинейные дифференциальные уравнения, дискретность пространства-времени и эпсилон произведение [1]. Вы увидите все пункты, кроме последнего.
Мне приходится читать много технической документации. На мой взгляд, общепринятая организация текста неудобна. У меня нет времени (да и желания) наслаждаться последовательным развитием сюжета и красотою слога, это не «Война и Мир», мне нужна лишь информация и чем быстрее, тем лучше. Поэтому в случае новой и сложной темы мне приходится сначала несколько раз сканировать текст в поисках смыслов, выводов и логики, и лишь потом я могу адекватно его воспринимать. То есть фактически я следую изложенному подходу, но в очень неудобной и затратной с точки зрения времени манере, и для меня было бы намного удобней, если бы информация сразу была бы организована соответствующим образом.
Автор: Roman Elokhin
Источник [2]
Сайт-источник PVSM.RU: https://www.pvsm.ru
Путь до страницы источника: https://www.pvsm.ru/dokumentirovanie/349664
Ссылки в тексте:
[1] Нелинейные дифференциальные уравнения, дискретность пространства-времени и эпсилон произведение: https://habr.com/ru/post/490878/
[2] Источник: https://habr.com/ru/post/492376/?utm_source=habrahabr&utm_medium=rss&utm_campaign=492376
Нажмите здесь для печати.