Background

Пишем документацию в геймдеве: четыре испытания для техписа

Иван Давыдов

Дата публикации: .

Если вы технический писатель и собираетесь перейти в игровую индустрию — эта статья для вас. Вы узнаете, что вас ждет в этой нелегкой работе: хаос документации, постоянные патчи, адская локализация и требования быть одновременно лингвистом, геймером и дизайнером. Статья содержит интерактивные элементы, которые помогут вам узнать, насколько вы готовы к геймдеву.

Первый шок: чем геймдев отличается от enterprise-софта

В enterprise всё предсказуемо. Годовой цикл обновления, регламенты, тикеты с пометкой "баг воспроизведён". Пока клиент слушает музыку на удержании, вы спокойно правите руководство.

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

Главное отличие: ваша ошибка видна миллионам игроков мгновенно. И никакого "стандартного акта сдачи-приёмки".

Две вселенных документации: внутренняя и внешняя

В геймдеве техпис работает сразу на два фронта. Ошибка на любом из них — и продукт страдает.

Параметр Внутренняя (для команды) Внешняя (для игроков)
Цель Синхронизировать разработку, сохранить знания Обучить, удержать, снизить отток
Кто читает Программисты, дизайнеры, художники, тестеры Новички, хардкорщики, моддеры
Форматы Confluence, Notion, GDD, TDD, Art Bible Вики, туториалы, подсказки UI, PDF
Срок жизни От идеи до Gold-версии (часто умирает раньше) Годы, иногда десятилетия (Skyrim до сих пор читают)
Инструменты MadCap Flare, Articy Draft, wiki-движки In-game UI, базы знаний, системы локализации

Внутренняя документация игры — это GDD (Game Design Document), "библия" игры. На практике она вечно устаревает, особенно в Agile. Внешняя, или пользовательская документация для игр, — то, что видит игрок: печатные мануалы (почти умерли), интерактивные гайды, контекстные подсказки и вики-порталы. Внешняя документация требует обновления после каждого патча.

Реальные уроки: как CD Projekt RED потеряла миллионы из-за хаоса в документации

На конференции Digital Dragons 2026 студия публично разобрала свои ошибки. Кейс — хрестоматийный.

Два кризиса:

  • Ремейк "Ведьмака" (2007). Исходной документации не было вообще. Пришлось восстанавливать логику старого кода по воспоминаниям ветеранов. Техписы занимались реверс-инжинирингом собственного наследия.
  • Cyberpunk 2077. Документации оказалось с избытком — более 8000 страниц. Но она превратилась в свалку: разные версии, разрозненные хранилища, две базы данных, которые не синхронизировались. Это сильно осложнило выпуск дополнения Phantom Liberty.

Вывод CDPR: документация обязательна на каждом этапе. Ввели правило "ворот" — без полного пакета документов нельзя перейти к следующей стадии.

"Любая документация лучше, чем никакой. Даже самый жуткий хаос можно распутать, но когда у вас вообще ничего нет — вы не можете ничего сделать. Вы не можете провести реверс-инжиниринг того, чего не существует".
— Ярослав Ручиньский, технический писатель CD Projekt RED

Испытание 1. Сравни масштаб документации Cyberpunk 2077 со своей

CD Projekt RED накопила 8000+ страниц документации по Cyberpunk 2077. Передвиньте ползунок, чтобы сравнить с вашим проектом.

Ваш проект: 1000 стр. Cyberpunk 2077: 8000 стр.
12.5%
от документации CDPR
0.8×
"Война и мир" (1225 стр.)
1.1×
Вся серия Гарри Поттера
50 см
высота стопки A4

В начало статьи

Другой путь: как Rockstar превратила документацию в часть игровой вселенной

Пока CDPR разгребала хаос, Rockstar пошла иным путём. Они отказались от бумажных мануалов ещё до того, как это стало мейнстримом. Их документация — это цифровая экосистема, встроенная в игру.

Яркий пример — Red Dead Redemption 2. Внутриигровой каталог Wheeler, Rawson and Co. — это 206 страниц текста, стилизованных под почтовый каталог 1899 года. Техписы написали описания товаров, которые одновременно погружают в эпоху, объясняют игровые механики и работают как полноценный справочник.

Вот как выглядит разница:

  • Enterprise-стиль: "Винтовка Springfield. Калибр .45-70, урон 80, скорострельность 6".
  • Геймдев-стиль (Rockstar): текст продавца из Дикого Запада, с намёком на надёжность в перестрелке, сравнением с конкурентами и лёгким сарказмом.

Техпис здесь — не просто автор инструкции, а писатель, дизайнер и лорист одновременно.

Испытание 2. Угадай: enterprise или геймдев?

Прочитайте отрывок документации и определите, из какого мира он взят.

Счёт: 0/5
"Для взаимодействия с объектом нажмите на кнопку действия. Кнопка действия расположена в правом нижнем углу интерфейса и обозначена символом [E]."
Отрывок 1 из 5
Ура!
Результат

В начало статьи

Обязан ли техпис играть в игры?

Если вы придёте в геймдев-студию и скажете, что не играете, — вероятность отказа очень высока. Игровой опыт — не каприз, а профессиональный инструмент.

Три железных аргумента "за":

  1. Эмпатия к игроку. Вы пишете не для "пользователя", а для "игрока". Разница — как между инструкцией к стиральной машине и сценарием квеста. Без собственного проживания опыта вы не поймёте, где новичок споткнётся.
  2. Терминология. Сленг (хитбокс, коллизия, тинкейт, пинг) усваивается только через практику.
  3. Проверка документации. Гайд по боссу можно написать, только пройдя его самому.

Когда можно не играть (исключения):

  • Документация по SDK / API / моддингу — там важнее код и архитектура.
  • Корпоративные симуляторы-тренажёры (медицина, авиация) — они ближе к enterprise.
  • Чистая локализация текста — но даже локализатору лучше понимать контекст.

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

Локализация: как кнопка ломает интерфейс

Локализация игровой документации — это не перевод, а создание текста с нуля. И вот три главных подвоха:

  • Длина строк. Английское "Settings" (8 символов) на португальском превращается в "Configurações" (14) — рост на 75%. Кнопка не влезает, интерфейс ломается.
  • Переменные и контекст. Фразы с {ИмяИгрока} требуют учёта родов и падежей. Во французском прилагательные и артикли зависят от гендера персонажа.
  • Культурные отсылки. Шутка, понятная американцу, может быть бессмысленной в Японии. Техпис должен закладывать адаптируемые блоки.

Без строгой, семантически чистой документации локализация превращается в лотерею.

Испытание 3. Локализуй текст кнопки

Выберите язык и посмотрите, что происходит с UI при переводе слова Settings — стандартной игровой кнопки.

Settings
ВЫЛЕЗ!
Контейнер: 120×40 px
Текст кнопки Settings
Символов 8
Рост vs English 0%
Статус UI OK


Итого: базовый английский — компактный, без падежей. Идеальная отправная точка для UI.

В начало статьи

Live-service: почему документация устаревает за неделю

Современные live-service игры обновляются каждую неделю. Для техписа это означает:

  • Скорость. Патч вышел — в тот же день обнови гайды, туториалы, подсказки. Игроки не простят устаревших инструкций.
  • Скриншоты. Ваши красивые иллюстрации устаревают за 7 дней. Кнопки переименовываются, интерфейс меняется — приходится автоматизировать захват или жить в режиме вечной гонки.
  • Версионирование. Кто-то не обновил игру — ему нужна старая версия. Консольные игроки видят другой UI. Документация должна жить параллельно на разных платформах и версиях.

Техпис в live-service похож на пожарного: он всегда в режиме ожидания. Это одна из главных причин, почему геймдев выматывает сильнее enterprise.

Подводные камни: SEO, долговечность и стоимость владения

Помимо явных трудностей, есть три "тихих убийцы", о которых редко говорят на собеседованиях.

  1. Поисковая оптимизация. Игроки ищут ответы не в вашей базе знаний, а в Google и на YouTube. Если документация не оптимизирована под поиск, её никто не найдёт. Игрок введёт "как открыть дверь", а не "для взаимодействия с объектом нажмите кнопку". Техпис должен думать как пользователь и писать как редактор.
  2. Долговечность. Игры живут десятилетиями. Skyrim перевыпускают до сих пор, и люди читают гайды 2011 года. Ваша документация должна работать через 10 лет: ссылки не вести в никуда, картинки не биться, форматы не устаревать. И через 10 лет в команде не останется никого, кто помнит, почему решение было принято.
  3. Совокупная стоимость владения (TCO). Внедрение инструментов (Confluence, MadCap Flare, Articy Draft) стоит не только денег на лицензию. Вы платите временем на обучение, нервами, когда половина команды игнорирует документацию, и репутацией, если документ не становится частью культуры. В геймдеве TCO выше из-за текучки кадров и спешки, убивающих регламенты.

Рабочий гибрид: документируйте только то, что реально меняется. Используйте wiki для текучки, HAT-инструменты для внешних руководств, а GDD превратите в живую базу знаний, а не мёртвый PDF.

Испытание 4. Готов ли ты к геймдеву?

Эмпатия к игроку невозможна без собственного опыта
Техпис в геймдеве — часто лорист и сценарист в одном лице
Инструменты enterprise и геймдева сильно различаются
Live-service не прощает отставания от релизного цикла
Игровой сленг усваивается только через практику
AAA-игры выходят в среднем на 7–10+ языках
Как каталог Wheeler, Rawson and Co. в RDR 2
В геймдеве текучка кадров и спешка убивают любые процессы

0/8
навыков
0%
готовности

В начало статьи

Итог: как не слить катку и когда стоит сказать "нет"

Игровая индустрия выматывает технического писателя сильнее любой другой. Три главных фактора — хаос документации, бесконечные обновления live-service и адская локализация — превращают работу в испытание на прочность.

Если вы:

  • не играете в игры (или играете редко),
  • не готовы к еженедельным патчам и пересъёмке скриншотов,
  • не умеете объяснять лор простыми словами,
  • не знаете разницы между хитбоксом и коллизией,
  • не работали с Articy Draft или системами локализации,

— подумайте дважды. Геймдев возьмёт вас, но выдержать его будет трудно.

Если же вы готовы — добро пожаловать. Это самая выматывающая, но и самая творческая индустрия для техписа. Здесь документация может быть искусством (как каталог в RDR 2), а ваша работа — влиять на эмоции миллионов игроков. Помните: внутренняя документация игры спасает команду от хаоса, а пользовательская документация для игр удерживает аудиторию и делает опыт игрока завершённым.

Прежде чем идти в геймдев, хотя бы месяц поиграйте в игры того жанра, который предстоит документировать. Если после этого энтузиазм не угас — дерзайте. Если угас — спасибо, что прочитали, и оставайтесь в enterprise. Там тоже есть свои герои.


Смотрите также