# ADR 0002. Аудио-версия объясняет смысл, а не транслитерирует нотацию

**Дата:** 2026-07-26
**Статус:** принято (заменяет первоначальный подход «нормализация текста»)

## Контекст

Первая гипотеза была такая: экранный текст непроизносим из-за нотации, значит
нужен слой нормализации — развернуть `↔`, `-128..127`, `O(1)`, кириллизовать
термины. Замер показал, что паттерны есть у 72% вопросов корпуса.

Слой написали, текст стал произносимым. И оказался всё равно плохим.

Формулировка, на которой это стало очевидно:

> «Мнемоника называется ПЕКС: продюсер экстендс, консьюмер супер.»
> «Лист, вайлдкард экстендс Намбер. Из такого списка удобно читать, а добавить
> Интеджер нельзя.»

Это не объяснение. Это **листинг, прочитанный вслух**. Ни преподаватель, ни
подкастер так не говорит: нотация остаётся глазам, вслух произносится идея.

## Решение

Аудио-версия — отдельный жанр, а не преобразование экранного текста.
Правила:

1. **Нотация заменяется смыслом, а не транскрипцией.** Не «лист вайлдкард
   экстендс Намбер», а «коллекция, из которой ты только читаешь».
2. **Каноническое название упоминается один раз, как ярлык.** «В книгах это
   называют PECS» — чтобы узнать термин от собеседника; расшифровка аббревиатуры
   объяснением не является.
3. **Причина идёт сразу за утверждением.** На экране «добавить нельзя»
   достаточно — глаз вернётся назад. В ухе возврата нет, поэтому «нельзя,
   потому что компилятор не знает, чей это список».
4. **Маркеры списка становятся словами.** Массив `traps[]` — это буллиты на
   экране и «две ловушки: первая… вторая…» в звуке.
5. **Ключевая мысль повторяется в конце одной фразой.** Перечитать нельзя.
6. **Отложенная ссылка проговаривается явно.** «Запомни оговорку, вернёмся
   к ней» в начале и «вот здесь и срабатывает та самая оговорка» в конце —
   на бумаге лишнее, в звуке единственный способ связать части.

## Последствия

- Аудио-текст примерно **в 1.8 раза длиннее** экранного (замерено на трёх
  образцах: ×2.3, ×1.4, ×1.7). Объём корпуса пересчитан с 9.5 до 16.5 часов.
- Автоматической генерацией такое не получить целиком. Расслоение:
  правила + структурные связки в коде дают «приемлемо» на 100% контента,
  переписывание — на приоритетных темах.
- Метрика подтвердила и качественный эффект: переписанный образец про
  дженерики дал CER 6.2% против 9.2% у прежней версии на том же движке.

## Побочный эффект, который оказался важным

Полная кириллизация терминов перестала быть опциональной полировкой:
Silero латиницу молча выбрасывает, Vosk падает с `KeyError`. См. [ADR 0001](0001-cer-round-trip-as-the-quality-metric.md).