Documentation

Technical documentation of the Quasar project

Принятые решения

Законы проекта, которые сторожит защита: нарушившая их правка не входит.

Законы проекта

Это не пожелания, а правила, которые сторожит защита. Нарушить их правкой нельзя: она не войдёт.

Ноль хардкода

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

Замер до постройки

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

Доказано действием

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

Проверять с парадного входа

Экзамены идут через тот же вход, которым пользуется человек, и с живым движком. Изоляция даёт
ложно-зелёный результат.

Мышление живёт в ядре

Всякий запрос сперва разбирает ядро: цель, наблюдения, связи, гипотезы. Органы знания
спрашиваются после и только по конкретному требованию дела. Улучшать поиск вместо вывода —
запрещено: это подмена задачи.

Слово «проверено» заслуживают делом

Сборка говорит лишь, что написанное не противоречит языку. Делает ли оно обещанное — вопрос
отдельный: движок ставит пробу, запускает и сравнивает. Не было сверки — так и говорит.

Фалбэк обязан объяснять

Не знаешь — скажи, что искал, где искал и чего не хватило. Молчание и выдумка запрещены
одинаково.

Один коммит за раз

Одна правка — одна мысль — один экзамен. Смешивать единицы в один коммит нельзя: потом не
разобрать, что именно дало прирост.