Словарь TradeAlmanac: почему определение живёт рядом с данными

Словарь TradeAlmanac устроен так, что статья не заканчивается определением: сразу под формулировкой стоит текущее значение того, о чём идёт речь. Это не оформительский приём. Термин рыночных данных нельзя проверить на словах — его проверяют подстановкой. Пока читатель не увидел, чему мультипликатор равен у конкретной бумаги прямо сейчас, он знает формулу, но не знает, что формула показывает. Поэтому в словаре определение и данные — один объект, а не две страницы, которые кто-то однажды поленился сверить.

Что ломается в словаре, оторванном от базы

Обычная энциклопедическая статья пишется один раз и после этого начинает расходиться с реальностью двумя способами.

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

Второй — расхождение методик. Определение описывает расчёт словами, а калькулятор на соседней странице считает по своей логике: другой знаменатель, другая отчётность, другой период. Формально противоречия нет, фактически читатель получает два разных ответа и не может понять, какой из них ответ площадки.

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

Как собирается статья словаря

Внутри определения стоят не цифры, а адреса в базе. Выглядит это так: определение мультипликатора заканчивается подстановкой 3,77 — и читатель видит, чему показатель равен у выбранной бумаги на момент открытия страницы. Карточка инструмента приходит директивой {{instrument:SBER}}, ближайшие выплаты — {{dividend_calendar|limit=5}}.

Следствие важнее механики. Статья словаря не имеет даты актуальности, потому что актуальность у неё не текстовая: устареть может формулировка, но не пример. Правка методики расчёта в базе меняет все статьи, которые на эту метрику ссылаются, — не нужно вручную искать упоминания.

Отдельно живут правовые величины. Налоговая база, лимиты, пороги приходят директивой вроде 13 % и тянут за собой свой источник — норму, из которой взяты. Такие величины меняются законом, а не рынком, и дата изменения у них иная, чем у рыночных данных. Номера статей и даты вступления в силу — единственные числа, которые в тексте написаны руками, потому что они и есть часть ссылки на источник.

Почему определение нельзя дать без оговорки

Большая часть статей словаря заканчивается не формулой, а границей применения. Это не осторожность ради осторожности: у рыночных терминов есть свойство выглядеть точнее, чем они есть.

Мультипликатор считается по отчётности, а отчётность выходит с задержкой и по разным стандартам — поэтому низкий P/E не означает «дешёво», он означает «надо посмотреть, что в знаменателе». Доходность облигации существует в нескольких несовпадающих вариантах, и расхождение между ними — не ошибка брокера, а разные вопросы к одной бумаге. Ликвидность в спокойном рынке не измеряется вовсе: её замечают, когда она заканчивается. Хешрейт сети — оценка, а не показание счётчика.

Определение без такой оговорки формально верно и практически опасно: читатель уносит число, не зная, при каких условиях оно перестаёт что-либо значить.

Как попасть в нужную статью

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

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

Второй маршрут — из материала журнала. Разбор ставит ссылку на термин там, где термин впервые понадобился, чтобы не объяснять его заново в каждом тексте.

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

Чего словарь не делает

Он не прогнозирует и не советует. Он не заменяет отчётность эмитента и не является источником данных сам по себе — он объясняет, как читать то, что отдаёт база.

И он не обещает полноты. Термины появляются в словаре по мере того, как появляются в данных площадки; если вы не нашли нужного слова, честный ответ — его пока нет, а не «смотрите похожее». Такие пропуски мы считаем задолженностью словаря, а не особенностью читателя.