aboutsummaryrefslogtreecommitdiff
path: root/docs/index.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/index.md')
-rw-r--r--docs/index.md95
1 files changed, 25 insertions, 70 deletions
diff --git a/docs/index.md b/docs/index.md
index ea17a63..25069a0 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,72 +1,27 @@
# FParkan
-FParkan -- самостоятельная техническая книга о восстановлении игрового движка
-Iron3D из *Parkan: Iron Strategy*. Она ведёт от запуска оригинальной программы
-и карты DLL к форматам ресурсов, загрузке миссии, геометрии, материалам,
-рендеру, поведению, звуку, сети и плану чистой совместимой реализации.
-
-Сайт оформлен как онлайн-книга: тома читаются последовательно, а справочник
-используется как быстрый доступ к форматам, проверочным правилам и границам
-доказанного знания.
-
-## Источник истины и синхронизация
-
-Каталог `docs/` — единственный рабочий источник истины для FParkan. 18 июля
-2026 года его содержательно сопоставили с книгой FParkan в Notion; результат,
-маршрутизация статей и сознательно исключённые цели зафиксированы в
-[сверке](baseline/notion-reconciliation.md). Актуальные локальные материалы
-содержат и последующие результаты разработки. Notion больше не
-является местом внесения изменений: новые факты, исправления и решения
-фиксируются только здесь, в томе, справочнике или evidence-документе, которому
-они принадлежат.
-
-При расхождении приоритет имеют более новое локальное доказательство и текущий
-scope проекта: самостоятельный runtime ориентирован исключительно на Windows и
-Vulkan. Исторические упоминания других ОС в старых внешних заметках не
-расширяют поддерживаемую платформу.
-
-Действующий dependency-ordered план `stage 0--5` находится в
-[Vulkan revision для Windows](baseline/vulkan-revision-plan.md). Это
-редакторская локальная версия: она включает недостающие контрактные требования
-из Notion, но не переносит снятые с проекта Linux/macOS и hosted-CI цели.
-
-## Как читать
-
-Если вы впервые разбираете игровой движок, начните с тома I и II. Там вводится
-лексика, доказательная политика, модульная архитектура и жизненный цикл кадра.
-
-Если нужна реализация совместимого движка, читайте тома III--VII линейно:
-ресурсы, миссии, мир, рендер, интерактивные подсистемы и порядок работ.
-
-Если вы проверяете выводы, переходите к тому VIII и приложениям. Там собраны
-уровни уверенности, corpus gates, открытые вопросы и критерии закрытия.
-
-## Восемь томов
-
-1. **Путеводитель и методика** -- назначение книги, маршруты чтения, язык
- предметной области и правила проверки.
-2. **Запуск, архитектура и игровой цикл** -- `iron_3d.exe`, пятнадцать DLL,
- сервисы, World3D, очередь объектов и границы кадра.
-3. **Ресурсная система и форматы** -- NRes, RsLi, кэши, имена, `objects.rlb`,
- unit DAT и сквозное разрешение ресурсов.
-4. **Мир, миссии и runtime** -- TMA, ландшафт, ареалы, маршруты, создание мира
- и свойства размещённых объектов.
-5. **Геометрия, материалы и рендер** -- MSH, анимация, WEAR, MAT0, Texm, FXID,
- свет, атмосфера и полный render frame.
-6. **Поведение, управление, звук и сеть** -- AI, Behavior, Wizard, Control,
- ввод, камера, звук и DirectPlay-слой.
-7. **Руководство по полной реализации** -- целевая архитектура, этапы работ,
- тестовый контур, точность, скорость и критерий совместимости.
-8. **Справочник и доказательная база** -- ABI, конфигурация, статистика
- корпусов, границы знания и глоссарий.
-
-## Политика доказательств
-
-Специфические утверждения об Iron3D принимаются только после локальной проверки
-на исполняемых файлах, DLL, демоверсии, полных каталогах Частей 1 и 2 или на
-взаимных инвариантах реальных ресурсов. Внешние описания и текущий код FParkan
-могут подсказывать вопросы, но не заменяют проверку.
-
-Неизвестные поля не получают правдоподобных имён. Пока смысл не закрыт,
-документация фиксирует raw layout, границы, безопасное чтение и lossless
-сохранение.
+Эта книга рассказывает, как устроен движок *Паркан: Железная стратегия* и как
+FParkan воспроизводит его работу на Rust и Vulkan. Начнём с простого вопроса:
+что должно произойти между выбором миссии и появлением первого кадра?
+Ответ связывает архивы, модели, поверхность карты, камеру, свет и поведение
+объектов в одну программу.
+
+Главы читаются последовательно. Для знакомства с игровой разработкой
+подойдут первые две; подробные структуры файлов можно искать в справочнике.
+
+1. [Путеводитель](tomes/01-guide.md): основные понятия и чтение бинарных структур.
+2. [Архитектура и игровой цикл](tomes/02-architecture.md): запуск, мир и кадр.
+3. [Ресурсы](tomes/03-resources.md): архивы, имена и связи файлов.
+4. [Миссии и ландшафт](tomes/04-world.md): размещение объектов и поверхность.
+5. [Геометрия и рендер](tomes/05-render.md): путь от вершины до пикселя.
+6. [Поведение, управление и звук](tomes/06-behavior.md): интерактивный мир.
+7. [Работа над движком](tomes/07-implementation.md): код, тесты и проверка результата.
+8. [Устройство оригинальной программы](tomes/08-evidence.md): DLL, адреса и конфигурация.
+
+В [глоссарии](appendices/glossary.md) собраны термины, а в
+[открытых вопросах](appendices/knowledge-boundaries.md) — ещё не восстановленное
+поведение. Описание алгоритма оригинала и возможности текущего приложения
+различаются явно. Предположение остаётся предположением, пока его не
+подтверждают игровые файлы или код оригинала.
+
+Команды запуска и проверки приведены в [README](../README.md).