В документации ключевую роль играет стиль изложения. Текст программного документа должен быть понятен и доступен читателю. Для достижения этой цели технические писатели обращаются к редакторскому опыту, а именно к информационному стилю.
Инфостиль – это набор редакторских приёмов, позволяющий создавать полезный для целевой аудитории текст. Такой подход позволяет насытить текст фактами и искоренить словесный мусор.
Зарождение инфостиля началось в начале XX века. Особую роль сыграла деятельность школы переводов И.А. Кашкина. До «кашкинцев» в текстах переводов придерживались буквальных формулировок, не учитывая различия в синтаксисе английского и русского языков. «Кашкинцы» соблюдали принципы лаконичности и однородности, которые позже стали основой информационного стиля. В текстах они заменяли отглагольные прилагательные глаголами, а также искореняли лишние причастные и деепричастные обороты.
Первой сформулировать принципы информационного стиля попыталась Н. Галь – советская переводчица английской и французской литературы. Славу ей принесли переводы «Маленького принца» и «Убить пересмешника». Н. Галь с трепетом относилась к родному языку и стремилась исключить из переводов «кривые» обороты. В 1972 г. была опубликована её книга «Слово живое и слово мёртвое». В книге автор разбирает возможные речевые ошибки на конкретных примерах. Вот некоторые принципы, намеченные автором:
- избегать канцелярского стиля;
- не бояться использовать глаголы;
- употреблять наиболее короткие формы слов;
- стремиться к понятным и ясным формулировкам.
- обоснованность и объективность высказываний;
- исключение вводных конструкций;
- сведение к минимальному количеству придаточных;
- отсутствие бессмысленных слов.
- краткость;
- честность;
- ясность;
- информативность;
- однозначность и объективность;
- упорядоченность;
- отсутствие эмоциональности.
Многие компании стремятся к соответствию документации требованиям ГОСТ. Требования к стилю изложения программных документов сформулированы в ГОСТ 19.106:
"Текст документа должен быть кратким, четким, исключающим возможность неверного толкования"
С одной стороны, ничего противоречащего принципам информационного стиля здесь нет. С другой стороны, 19 серия ГОСТов устанавливает конкретные разделы, которые могут дублироваться в различных документах. Это делает тексты для читателя «перегруженными» и сложными для восприятия.
Если требований ГОСТ не избежать, технический писатель может придерживаться принципов информационного стиля в рамках одного документа или его раздела. Комбинирование подходов позволяет привести документ к необходимой форме, при этом донести до читателя информацию понятным языком.
К принципам, заложившим основу информационного стиля, обращались переводчики, журналисты, редакторы и авторы разных эпох. Характерные ему приёмы позволяют по сей день делать тексты информативными, однозначными и упорядоченными.