Требования ГОСТов относятся не только к оформлению документов, но и к их содержанию. В частности, ГОСТы определяют смысловое наполнение всех разделов, а также требования к изложению текста документа.

Как правило, в разработке технической документации принимают участие несколько специалистов, каждый из которых излагает свою часть в присущей ему манере, используя собственные термины. При формировании полного текста документа эти особенности требуют приведения к единообразию.

Часто под одним и тем же термином разные специалисты подразумевают совершенно разные понятия, и поэтому такие тексты напоминают забавную сказку «Пуськи Бятые» замечательной писательницы Л. С. Петрушевской:

Сяпала Калуша с Калушатами по напушке. И увазила Бутявку, и волит:

— Калушата! Калушаточки! Бутявка!

Калушата присяпали и Бутявку стрямкали. И подудонились.

А Калуша волит:

— Оее! Оее! Бутявка‑то некузявая!

Калушата Бутявку вычучили.

Бутявка вздребезнулась, сопритюкнулась и усяпала с напушки.

А Калуша волит калушатам:

— Калушаточки! Не трямкайте бутявок, бутявки дюбые и зюмо‑зюмо некузявые. От бутявок дудонятся.

А Бутявка волит за напушкой:

— Калушата подудонились! Зюмо некузявые! Пуськи бятые! 

В зависимости от принятой терминологии сказка может превратиться в другой жанр. Например, если под Калушей и Бутявкой понимать конкурирующих руководителей или бандитов, то получится производственная или криминальная драма, а если кровожадных монстров, вроде Дракулы или Чужого, – то  вампирский или фантастический триллер :).

С формальной точки зрения наилучшим определением термина является, конечно же, определение, данное в ГОСТах, соответствующих предметной области. К сожалению, в официальных стандартах имеются далеко не все термины. Особенно это актуально для области ИТ по двум причинам.

1. ИТ развиваются настолько быстро (например, нейронные сети), что организации, занимающиеся стандартизацией в этой области, не успевают своевременно разрабатывать соответствующие термины. В условиях отсутствия стандартных определений терминов разработчики документов часто пользуются собственными.

2. Почти все термины в этой сфере англоязычные, и разработка отечественных аналогов еще более усугубляет временно́е отставание, а их русскоязычный перевод иногда вообще не соответствует сути. Например, термин «remote access» с точки зрения русского языка грамотнее перевести как «дистанционный доступ», но прижился общепринятый «удаленный доступ», в т.ч. и в ГОСТах, правда, в разных формулировках.

В таблице ниже приведены примеры формулировок термина «удаленный доступ» из разных ГОСТов.

Как видно из таблицы, в термин «удаленный доступ» в разных ГОСТах вкладывается разный смысл: технический процесс получения канала передачи данных к информационным ресурсам и/или их дистанционное использование. Безусловно, определение термина зависит от предметной области разрабатываемого документа, и специалистам обычно понятна его суть из контекста. Тем не менее, документ должен быть понятен любому специалисту, даже не обладающему достаточными специальными знаниями.

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

Проблема терминологии еще более усугубляется при полном отсутствии нужного термина, например, в совершенно новой области, которая уже достаточно популярна и быстро развивается, но терминология еще не успела устояться, и поэтому каждый разработчик использует свою собственную; или в проприетарной технологии, в которой используются термины, придуманные ее создателями. В этом случае требуется придумать русскоязычное название самого термина и сформулировать его смысл. При этом название термина, как ни странно, может совсем не отражать суть вкладываемого понятия.

В этом контексте очень показателен пример компьютерной мыши. Риторический вопрос: разве это компьютерное устройство похоже на мышь?

Если считать сходством размер и провод, похожий на хвост, то хвост есть не только у мыши. Почему не назвали кротом, например? Тем не менее, название прижилось, у современных беспроводных мышей «хвост» отсутствует совсем, и коврик для мыши уже ни у никого не вызывает ассоциативную аналогию с кроватью для таракана :).

Иногда термин вроде «мыши» по разным причинам неприемлем, а требуется часто использовать длинное и нечитабельное название, которое само состоит из нескольких терминов, например, "рекуррентная нейронная сеть, реализованная на архитектуре долгой краткосрочной памяти," или "пользовательское адресное пространство привилегированного процесса". Очевидным разумным выходом из положения является использование аббревиатур.

Требования и правила сокращения слов и словосочетаний хорошо описаны в ГОСТ 7.11-2004 (Система стандартов по информации, библиотечному и издательскому делу. Библиографическая запись. Сокращение слов и словосочетаний на иностранных европейских языках) и ГОСТ Р 7.0.12-2011 (Система стандартов по информации, библиотечному и издательскому делу. Библиографическая запись. Сокращение слов и словосочетаний на русском языке. Общие требования и правила), которые, строго говоря, не являются обязательными при разработке технической документации, но очень полезны для общего понимания правил создания аббревиатур.

Очень часто в технической документации используются иностранные и русскоязычные общеупотребительные аббревиатуры терминов, которые не нуждаются в определениях, их требуется только расшифровать. С аббревиатурами, разрабатываемыми только для локального применения, дело обстоит сложнее из-за особенностей нашего языка и возможных негативных ассоциаций. Вот пример неудачного использования аббревиатуры названия «Всероссийский научно-исследовательский геологический институт им. А.П. Карпинского» (https://vsegei.ru/ru/) :):

Вот тут-то и пригодятся вышеупомянутые ГОСТы и, особенно, творческие способности :)

В этой статье я постарался обратить внимание разработчиков технической документации на важность использования корректных терминов и аббревиатур. Оформление текстовых документов по требованиям ГОСТов требует от разработчиков знания предметной области и, несмотря на обилие не всегда понятных ограничений и требований, творческих усилий.