Глоссарий проекта: как вести термины
Термины расходятся незаметно: в одном документе «учётная запись», в другом «аккаунт», в третьем «профиль пользователя». Каждый вариант по отдельности понятен, вместе они создают ощущение небрежности.
Глоссарий решает эту проблему, если вести его как рабочий инструмент, а не как приложение к отчёту.
Зачем нужен глоссарий
Глоссарий фиксирует договорённость: какое слово команда считает основным и какие варианты допустимы. Без такой фиксации каждый автор выбирает по своему вкусу.
Для перевода это ещё важнее: расхождение терминов ломает поиск, справку и обучение пользователей.
Минимальная структура записи
Практичная запись содержит термин, определение, основной вариант перевода, допустимые синонимы, запрещённые варианты, область применения и источник решения. Этого достаточно, чтобы новый участник понял выбор.
Поля не должны дублировать энциклопедию: определение пишется в одно-два предложения и служит для различения, а не для объяснения мира.
Определение термина
Определение отвечает на вопрос «что это в рамках проекта». Оно не обязано быть универсальным, но должно позволять отличить термин от смежного понятия.
Если термин заимствован из стандарта, определение лучше цитировать с указанием источника и не переписывать своими словами без необходимости.
Основной вариант
У каждого термина должен быть один основной вариант. Остальные помечаются как допустимые или нежелательные — иначе глоссарий превращается в список равноправных мнений.
Правило «один термин — один вариант» особенно важно в интерфейсах, где пользователь встречает слово в меню, подсказке и документации.
Запрещённые варианты
Поле «не использовать» экономит больше времени, чем поле «использовать»: редактор сразу видит, что нужно исправить. В него попадают кальки, устаревшие формы и варианты, вызывающие путаницу.
Запрет должен быть обоснован: «так решили» без причины быстро забывается и нарушается.
Согласование
Глоссарий становится обязательным только после согласования с теми, кто пишет и переводит. Решение, принятое редактором в одиночку, саботируется молча.
Фиксируйте не только итог, но и дату, участников и аргументы: через полгода это спасёт от повторного спора.
Источники термина
Указывайте, откуда взят вариант: стандарт, глоссарий заказчика, отраслевой словарь, сложившаяся практика. Ссылка на источник повышает доверие и упрощает пересмотр.
Если источники противоречат друг другу, решение всё равно нужно принять — и записать, почему выбран один из них.
Область применения
Один и тот же термин может переводиться по-разному в разных продуктах или разделах. Поле «область» позволяет держать несколько вариантов в одном файле без конфликта.
Без этого поля команда начинает спорить о случаях, которые на самом деле регулируются разными правилами.
Версионирование
Глоссарий меняется: появляются новые термины, старые решения пересматриваются. Храните историю изменений и не удаляйте прежние варианты бесследно.
Если глоссарий лежит в репозитории, история коммитов уже решает задачу — при условии осмысленных сообщений.
Формат хранения
Таблица подходит для небольшого проекта, но плохо переживает сложные связи. Структурированный файл с полями удобнее для проверок и автоматизации.
Главное требование — единый формат и доступность всем участникам, а не конкретный инструмент.
Проверка текстов
Глоссарий бесполезен, если им не пользуются при проверке. Добавьте поиск по запрещённым вариантам в редакторский чек-лист.
Автоматическая проверка находит расхождения быстрее, чем вычитка вручную, но не заменяет понимание контекста.
Пополнение
Новые термины появляются в проекте постоянно. Заведите простое правило: если слово встретилось дважды и вызывает сомнение, оно попадает в глоссарий.
Так список растёт постепенно и остаётся управляемым, а не превращается в свалку после аврала.
Роли
Нужен один ответственный за глоссарий: он принимает решения и следит за порядком. Коллеги предлагают, но не меняют записи хаотично.
В небольшой команде эту роль может совмещать редактор, если он участвует в обсуждении терминов.
Типичные ошибки
Самая частая — глоссарий без определений, где собраны только пары слов. Вторая — отсутствие владельца, из-за чего записи противоречат друг другу.
Третья ошибка — попытка включить в глоссарий всю отраслевую терминологию. Он нужен для спорных случаев, а не для словаря на тысячу страниц.
Пример записи
Термин: «учётная запись». Определение: набор данных, по которым система различает пользователя. Основной вариант: «учётная запись». Допустимо: «аккаунт» в маркетинговых текстах. Не использовать: «профиль» для входа в систему.
Источник: глоссарий заказчика, версия 3. Дата решения: март 2026. Владелец: редактор продукта.
Связь со словарями
Глоссарий не заменяет словари: он фиксирует решение проекта, а словарь описывает язык. При сомнении сначала смотрят в словарь, затем — в глоссарий.
Если глоссарий противоречит стандарту, это нужно отметить явно и объяснить причину отступления.
Работа с аббревиатурами
Сокращения входят в глоссарий отдельными записями, даже если основная форма уже описана. Иначе один автор пишет «МИС», другой «медицинская информационная система», третий — оба варианта в одном абзаце.
Для каждой аббревиатуры укажите расшифровку и правило первого упоминания в тексте.
Обучение новых участников
Новый переводчик или редактор должен за полчаса понять, как пользоваться глоссарием. Если для этого нужна встреча, структура слишком сложная.
Короткая инструкция на первой странице файла решает задачу лучше, чем подробный регламент.
Как понять, что глоссарий работает
Признак пользы — снижение числа правок одного типа. Если редактор перестал исправлять «аккаунт» на «учётную запись», значит договорённость действует.
Обратный сигнал — вопросы «а как у нас принято» в чате команды.
Чек-лист
- Термин имеет определение.
- Основной вариант один.
- Запрещённые варианты перечислены.
- Источник указан.
- Область применения задана.
- Владелец назначен.
- Проверка текстов настроена.
Частые вопросы
Сколько терминов нужно?
Начните с тех, что уже вызвали спор.
Нужен ли глоссарий одному автору?
Да, если он возвращается к проекту через месяцы.
Где хранить?
Там, где команда реально работает с текстами.