К ГОСТ 19-й и 34-й серий можно относиться по-разному, но эти стандарты продолжают играть важную роль в жизни IT-специалистов. Особенно — в жизни технических писателей. Часть документов, упомянутых в стандартах, встречается почти в каждом проекте. Техническое задание, пояснительная записка, руководство пользователя — с этими документами сталкивался почти каждый технический писатель.
Но время от времени в проект закрадываются «экзотические» документы, описание которых в ГОСТ скорее ставит в тупик, чем помогает. А иногда затруднения вызывают знакомые документы в нестандартных ситуациях, когда требуется описать что-то, чего в системе, на первый взгляд, не существует.
Как правило, для того чтобы хорошо писать такие документы, необходимо понимать, какой смысл закладывали в них авторы стандартов, понимать их понятийный аппарат. Об этом и пойдет речь в докладе.