Журнал изменений терминологии

• 2026-04-27 · merged · Админ: слияние term_key 6372f95c-158a-48b5-b4dd17e764e3 → 4ba4ff6e-a00c-4992-aa984499e811 (победитель при дубле локали: primary).
• 2026-04-27 · merged · Админ: слияние term_key c81f36e2-99a1-4387-8bcad145ea5c → 29f0f49b-48c3-47c4-b290f0d25da1 (победитель при дубле локали: secondary).
• 2026-04-27 · merged · Админ: слияние term_key a1f58a70-af3f-483a-9b4345c52bfa → 06434347-d8c0-4be1-97955c836e73 (победитель при дубле локали: primary).
• 2026-04-27 · structure · Введён runtime БД и импорт из outline с отчётом 1:1.
• 2026-04-27 · merged · В docs/curl-basics-outline.md объединены пары терминов (HTTP-заголовки; тело/payload и -d); старые slug перенаправляются на канонические.
• 2026-04-27 · policy · Зафиксирована политика URL-стабильности: 301 при смене slug и реестр deprecated-алиасов.
• 2026-04-27 · added · Создан каркас Glossary v1 с каноническими slug и контент-моделью.

MVP DoD / QA-гейт

• URL-структура `/docs/glossary/`, `/terms/`, `/terms/<slug>/`, `/synonyms/`, `/changes/` доступна.
• У каждого термина есть required-поля: term, slug, shortDefinition, context, practicalTakeaway, relatedTerms, confusedWith, status, lastUpdated, sourceAnchor.
• Для конфликтных терминов заполнен блок «Не путать с».
• Синонимы указывают на канонический URL.
• Битых внутренних ссылок: 0.

Правила slug и URL

• Slug нормализуется в lowercase + kebab-case (латиница, цифры, дефис).
• Канон: 1 термин = 1 канонический slug; синонимы ведут на канон через `/synonyms/` и редиректы.
• При переименовании сохраняется стабильность URL; если смена неизбежна — 301 со старого slug.
• Нежелательные slug: служебные и конфликтующие (`index`, `new`, `edit`, `api`, `tmp`, `test`, `terms`, `synonyms`, `changes`).

Контент-модель термина

• Required: term, slug, shortDefinition, context, practicalTakeaway, relatedTerms, confusedWith, status, lastUpdated, sourceAnchor.
• Optional: examples, vendorScope, vendorNotes, synonyms, deprecatedAliases.
• Определение всегда vendor-neutral; вендорные детали выносятся в vendorNotes.
• Примеры — короткие, безопасные, без секретов; один пример = одна цель.
• «Практический вывод» — 1-2 actionable пункта, без пересказа определения.

Execution order (MVP)

1. Инвентаризация и каноникализация терминов из источника `L1380+`.
2. Фиксация контент-модели страницы термина и статусов (`draft/approved/deprecated`).
3. Публикация URL-дерева и поиска (`/glossary/`, `/terms/`, `/synonyms/`, `/changes/`).
4. Миграция MVP-пакета терминов с заполнением связей `related` и `confusedWith`.
5. QA-гейт: ссылочная связность, валидация slug, контроль конфликтных терминов.
6. Публикация Glossary v1 и запись изменений в changelog.

Риски и контроль

• Риск: конфликтные формулировки дублей. Контроль: единый канонический термин и alias-таблица.
• Риск: размытые практические выводы. Контроль: формат 1-2 actionable пункта.
• Риск: перегруз vendor-specific деталями. Контроль: нейтральная дефиниция + отдельный vendor-note.
• Риск: битые связи. Контроль: гейт по внутренним ссылкам перед публикацией.

Текущее покрытие

Канонических терминов в v1: 35. Ядро терминов включено.