diff --git a/AGENTS.md b/AGENTS.md index 04cf8db..cfbe95c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -40,7 +40,7 @@ bin/ docs/ git-workflow/ # Документация, копируемая в проект-потребитель index.md # Оглавление раздела - glossary.md # Словарь терминов со ссылками на определения + glossary/ # Словарь терминов: index.md + один файл на термин branches.md # Ветки: типы, именование, жизненный цикл commits.md # Conventional Commits: формат и правила pull-request.md # Процесс PR и требования diff --git a/README.md b/README.md index e64ba73..763e495 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,7 @@ ## Правила -- **[Словарь терминов](docs/git-workflow/glossary.md)** — короткие определения со ссылками на отдельные термины +- **[Словарь терминов](docs/git-workflow/glossary/index.md)** — определения терминов, один термин — один файл - **Ветки** — как назвать ветку для задачи, релиза или хотфикса; когда удалить - **Коммиты** — Conventional Commits: тип, scope, subject — чтобы история читалась как журнал изменений - **Пулреквесты** — от создания до мержа: проверки, ревью, squash diff --git a/docs/git-workflow/glossary.md b/docs/git-workflow/glossary.md deleted file mode 100644 index 28837c9..0000000 --- a/docs/git-workflow/glossary.md +++ /dev/null @@ -1,93 +0,0 @@ ---- -package: prikotov/git-workflow ---- - -# Словарь терминов (Glossary) - -Термины используются в значениях ниже. На отдельное определение можно ссылаться по якорю, например: [выкладка](#deployment). - -## Репозиторий и ветки - - -**Репозиторий (Repository)** — хранилище файлов проекта и истории их изменений в Git. - - -**Ветка (Branch)** — именованная линия разработки, указатель которой перемещается при добавлении коммитов. - - -**Основная ветка (Main branch)** — ветка по умолчанию репозитория, в которую включаются согласованные изменения и от которой готовятся обычные релизы. - - -**Релизная ветка (Release branch)** — ветка подготовки одной конкретной версии, например `release/1.2.1`. В этом процессе сохраняется после выпуска и не переиспользуется для другой версии. - - -**Коммит (Commit)** — запись в истории Git, фиксирующая состояние файлов, автора, сообщение и связь с предыдущей историей. - - -**Идентификатор коммита (Commit SHA)** — хеш, по которому Git однозначно находит конкретный коммит, независимо от последующих изменений ветки. - - -**Тег релиза (Release tag)** — именованная отметка коммита выпуска, например `v1.2.1`. В этом процессе опубликованный тег неизменяем. - -## Проверка и включение изменений - - -**Запрос на слияние (Pull Request, PR)** — предложение включить изменения из исходной ветки в целевую; содержит обсуждение, результаты проверок и решение по изменениям. - - -**Ревью кода (Code review)** — проверка предложенных изменений человеком или агентом: корректности, понятности и соответствия правилам проекта. - - -**Одобрение (Approval)** — подтверждение, что проверенное состояние изменений принято проверяющим. Разрешения на слияние и выпуск определяются отдельно по [правилам PR](pull-request.md). - - -**Слияние веток (Merge)** — объединение истории разработки для включения изменений одной ветки в другую. - - -**Объединение коммитов (Squash)** — сведение изменений нескольких коммитов в один новый коммит. - - -**Перенос коммитов (Rebase)** — повторное применение изменений коммитов к новой базе; пересозданные коммиты получают новые идентификаторы. - - -**Непрерывная интеграция (Continuous Integration, CI)** — регулярное объединение изменений, сопровождаемое автоматической сборкой и проверками. - - -**Сквозные тесты (End-to-end tests, E2E)** — проверки пользовательских сценариев целиком через публичные интерфейсы приложения. - -## Версии и релизы - - -**Версия (Version)** — определённое состояние продукта, обозначенное номером, например `1.2.1`. - - -**Семантическое версионирование (Semantic Versioning, SemVer)** — правила выбора номера `major.minor.patch` с учётом характера изменений и совместимости. Применение к версиям `0.x` и `1.x` описано в [регламенте релизов](release.md#semver-и-линии-релиза). - - -**Релиз (Release)** — опубликованная версия продукта; её публикация не означает, что она уже установлена в рабочей среде. - - -**Выпуск (Release publishing)** — публикация подготовленной версии: тега и записи GitHub Release после необходимых проверок и разрешений. Не включает [выкладку](#deployment). - - -**Запись релиза на GitHub (GitHub Release)** — запись на GitHub, связанная с тегом и содержащая описание версии; к ней могут прилагаться файлы для скачивания. Это не сам тег и не установка приложения. - - -**Фиксация состава релиза (Release cut)** — определение окончательного набора изменений при одобрении PR подготовки релиза. - - -**План релиза (Release plan)** — документ с составом версии, рисками и действиями до и после её выпуска и выкладки. - - -**Срочное исправление (Hotfix)** — исправление ошибки в рабочей версии без нарушения совместимости; готовится от тега текущей версии рабочей среды. - - -**Патч-релиз (Patch release)** — релиз совместимых исправлений ошибок с увеличением третьего числа версии, например `1.2.0` → `1.2.1`. Такое повышение версии само по себе не означает срочность выпуска. - -## Выкладка и рабочая среда - - -**Выкладка (Deployment, deploy)** — установка выбранной версии в целевую среду. В этом процессе рабочая среда обновляется по опубликованному тегу, а не по вершине ветки. - - -**Рабочая среда (Production)** — среда, в которой приложение обслуживает реальных пользователей и работает с рабочими данными. diff --git a/docs/git-workflow/glossary/approval.md b/docs/git-workflow/glossary/approval.md new file mode 100644 index 0000000..099ca33 --- /dev/null +++ b/docs/git-workflow/glossary/approval.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Одобрение (Approval) + +Подтверждение, что проверенное состояние изменений принято проверяющим. Разрешения на слияние и выпуск определяются отдельно по [правилам PR](../pull-request.md). diff --git a/docs/git-workflow/glossary/branch.md b/docs/git-workflow/glossary/branch.md new file mode 100644 index 0000000..dd6efde --- /dev/null +++ b/docs/git-workflow/glossary/branch.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Ветка (Branch) + +Именованная линия разработки, указатель которой перемещается при добавлении коммитов. diff --git a/docs/git-workflow/glossary/ci.md b/docs/git-workflow/glossary/ci.md new file mode 100644 index 0000000..762ae69 --- /dev/null +++ b/docs/git-workflow/glossary/ci.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Непрерывная интеграция (Continuous Integration, CI) + +Регулярное объединение изменений, сопровождаемое автоматической сборкой и проверками. diff --git a/docs/git-workflow/glossary/code-review.md b/docs/git-workflow/glossary/code-review.md new file mode 100644 index 0000000..1b087ef --- /dev/null +++ b/docs/git-workflow/glossary/code-review.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Ревью кода (Code review) + +Проверка предложенных изменений человеком или агентом: корректности, понятности и соответствия правилам проекта. diff --git a/docs/git-workflow/glossary/commit-sha.md b/docs/git-workflow/glossary/commit-sha.md new file mode 100644 index 0000000..ed31530 --- /dev/null +++ b/docs/git-workflow/glossary/commit-sha.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Идентификатор коммита (Commit SHA) + +Хеш, по которому Git однозначно находит конкретный коммит, независимо от последующих изменений ветки. diff --git a/docs/git-workflow/glossary/commit.md b/docs/git-workflow/glossary/commit.md new file mode 100644 index 0000000..a601815 --- /dev/null +++ b/docs/git-workflow/glossary/commit.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Коммит (Commit) + +Запись в истории Git, фиксирующая состояние файлов, автора, сообщение и связь с предыдущей историей. diff --git a/docs/git-workflow/glossary/deployment.md b/docs/git-workflow/glossary/deployment.md new file mode 100644 index 0000000..e3f2b98 --- /dev/null +++ b/docs/git-workflow/glossary/deployment.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Выкладка (Deployment, deploy) + +Установка выбранной версии в целевую среду. В этом процессе рабочая среда обновляется по опубликованному тегу, а не по вершине ветки. diff --git a/docs/git-workflow/glossary/e2e-tests.md b/docs/git-workflow/glossary/e2e-tests.md new file mode 100644 index 0000000..dd3bf41 --- /dev/null +++ b/docs/git-workflow/glossary/e2e-tests.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Сквозные тесты (End-to-end tests, E2E) + +Проверки пользовательских сценариев целиком через публичные интерфейсы приложения. diff --git a/docs/git-workflow/glossary/github-release.md b/docs/git-workflow/glossary/github-release.md new file mode 100644 index 0000000..5a69cf5 --- /dev/null +++ b/docs/git-workflow/glossary/github-release.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Запись релиза на GitHub (GitHub Release) + +Запись на GitHub, связанная с тегом и содержащая описание версии; к ней могут прилагаться файлы для скачивания. Это не сам тег и не установка приложения. diff --git a/docs/git-workflow/glossary/hotfix.md b/docs/git-workflow/glossary/hotfix.md new file mode 100644 index 0000000..caa239a --- /dev/null +++ b/docs/git-workflow/glossary/hotfix.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Срочное исправление (Hotfix) + +Исправление ошибки в рабочей версии без нарушения совместимости; готовится от тега текущей версии рабочей среды. diff --git a/docs/git-workflow/glossary/index.md b/docs/git-workflow/glossary/index.md new file mode 100644 index 0000000..ba0780b --- /dev/null +++ b/docs/git-workflow/glossary/index.md @@ -0,0 +1,45 @@ +--- +package: prikotov/git-workflow +--- + +# Словарь терминов (Glossary) + +Термины используются в значениях ниже. На отдельное определение можно ссылаться файлом термина, например: [выкладка](deployment.md). + +## Репозиторий и ветки + +- [Репозиторий (Repository)](repository.md) +- [Ветка (Branch)](branch.md) +- [Основная ветка (Main branch)](main-branch.md) +- [Релизная ветка (Release branch)](release-branch.md) +- [Коммит (Commit)](commit.md) +- [Идентификатор коммита (Commit SHA)](commit-sha.md) +- [Тег релиза (Release tag)](release-tag.md) + +## Проверка и включение изменений + +- [Запрос на слияние (Pull Request, PR)](pull-request.md) +- [Ревью кода (Code review)](code-review.md) +- [Одобрение (Approval)](approval.md) +- [Слияние веток (Merge)](merge.md) +- [Объединение коммитов (Squash)](squash.md) +- [Перенос коммитов (Rebase)](rebase.md) +- [Непрерывная интеграция (Continuous Integration, CI)](ci.md) +- [Сквозные тесты (End-to-end tests, E2E)](e2e-tests.md) + +## Версии и релизы + +- [Версия (Version)](version.md) +- [Семантическое версионирование (Semantic Versioning, SemVer)](semver.md) +- [Релиз (Release)](release.md) +- [Выпуск (Release publishing)](release-publishing.md) +- [Запись релиза на GitHub (GitHub Release)](github-release.md) +- [Фиксация состава релиза (Release cut)](release-cut.md) +- [План релиза (Release plan)](release-plan.md) +- [Срочное исправление (Hotfix)](hotfix.md) +- [Патч-релиз (Patch release)](patch-release.md) + +## Выкладка и рабочая среда + +- [Выкладка (Deployment, deploy)](deployment.md) +- [Рабочая среда (Production)](production.md) diff --git a/docs/git-workflow/glossary/main-branch.md b/docs/git-workflow/glossary/main-branch.md new file mode 100644 index 0000000..324106d --- /dev/null +++ b/docs/git-workflow/glossary/main-branch.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Основная ветка (Main branch) + +Ветка по умолчанию репозитория, в которую включаются согласованные изменения и от которой готовятся обычные релизы. diff --git a/docs/git-workflow/glossary/merge.md b/docs/git-workflow/glossary/merge.md new file mode 100644 index 0000000..d0e0fe8 --- /dev/null +++ b/docs/git-workflow/glossary/merge.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Слияние веток (Merge) + +Объединение истории разработки для включения изменений одной ветки в другую. diff --git a/docs/git-workflow/glossary/patch-release.md b/docs/git-workflow/glossary/patch-release.md new file mode 100644 index 0000000..ecfeae9 --- /dev/null +++ b/docs/git-workflow/glossary/patch-release.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Патч-релиз (Patch release) + +Релиз совместимых исправлений ошибок с увеличением третьего числа версии, например `1.2.0` → `1.2.1`. Такое повышение версии само по себе не означает срочность выпуска. diff --git a/docs/git-workflow/glossary/production.md b/docs/git-workflow/glossary/production.md new file mode 100644 index 0000000..19b0b50 --- /dev/null +++ b/docs/git-workflow/glossary/production.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Рабочая среда (Production) + +Среда, в которой приложение обслуживает реальных пользователей и работает с рабочими данными. diff --git a/docs/git-workflow/glossary/pull-request.md b/docs/git-workflow/glossary/pull-request.md new file mode 100644 index 0000000..083cf56 --- /dev/null +++ b/docs/git-workflow/glossary/pull-request.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Запрос на слияние (Pull Request, PR) + +Предложение включить изменения из исходной ветки в целевую; содержит обсуждение, результаты проверок и решение по изменениям. diff --git a/docs/git-workflow/glossary/rebase.md b/docs/git-workflow/glossary/rebase.md new file mode 100644 index 0000000..f2c7828 --- /dev/null +++ b/docs/git-workflow/glossary/rebase.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Перенос коммитов (Rebase) + +Повторное применение изменений коммитов к новой базе; пересозданные коммиты получают новые идентификаторы. diff --git a/docs/git-workflow/glossary/release-branch.md b/docs/git-workflow/glossary/release-branch.md new file mode 100644 index 0000000..68672e2 --- /dev/null +++ b/docs/git-workflow/glossary/release-branch.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Релизная ветка (Release branch) + +Ветка подготовки одной конкретной версии, например `release/1.2.1`. В этом процессе сохраняется после выпуска и не переиспользуется для другой версии. diff --git a/docs/git-workflow/glossary/release-cut.md b/docs/git-workflow/glossary/release-cut.md new file mode 100644 index 0000000..714c113 --- /dev/null +++ b/docs/git-workflow/glossary/release-cut.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Фиксация состава релиза (Release cut) + +Определение окончательного набора изменений при одобрении PR подготовки релиза. diff --git a/docs/git-workflow/glossary/release-plan.md b/docs/git-workflow/glossary/release-plan.md new file mode 100644 index 0000000..b20dcd2 --- /dev/null +++ b/docs/git-workflow/glossary/release-plan.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# План релиза (Release plan) + +Документ с составом версии, рисками и действиями до и после её выпуска и выкладки. diff --git a/docs/git-workflow/glossary/release-publishing.md b/docs/git-workflow/glossary/release-publishing.md new file mode 100644 index 0000000..94b6804 --- /dev/null +++ b/docs/git-workflow/glossary/release-publishing.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Выпуск (Release publishing) + +Публикация подготовленной версии: тега и записи GitHub Release после необходимых проверок и разрешений. Не включает [выкладку](deployment.md). diff --git a/docs/git-workflow/glossary/release-tag.md b/docs/git-workflow/glossary/release-tag.md new file mode 100644 index 0000000..1feaf1d --- /dev/null +++ b/docs/git-workflow/glossary/release-tag.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Тег релиза (Release tag) + +Именованная отметка коммита выпуска, например `v1.2.1`. В этом процессе опубликованный тег неизменяем. diff --git a/docs/git-workflow/glossary/release.md b/docs/git-workflow/glossary/release.md new file mode 100644 index 0000000..e090c22 --- /dev/null +++ b/docs/git-workflow/glossary/release.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Релиз (Release) + +Опубликованная версия продукта; её публикация не означает, что она уже установлена в рабочей среде. diff --git a/docs/git-workflow/glossary/repository.md b/docs/git-workflow/glossary/repository.md new file mode 100644 index 0000000..8286814 --- /dev/null +++ b/docs/git-workflow/glossary/repository.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Репозиторий (Repository) + +Хранилище файлов проекта и истории их изменений в Git. diff --git a/docs/git-workflow/glossary/semver.md b/docs/git-workflow/glossary/semver.md new file mode 100644 index 0000000..e7dc557 --- /dev/null +++ b/docs/git-workflow/glossary/semver.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Семантическое версионирование (Semantic Versioning, SemVer) + +Правила выбора номера `major.minor.patch` с учётом характера изменений и совместимости. Применение к версиям `0.x` и `1.x` описано в [регламенте релизов](../release.md#semver-и-линии-релиза). diff --git a/docs/git-workflow/glossary/squash.md b/docs/git-workflow/glossary/squash.md new file mode 100644 index 0000000..9c266a6 --- /dev/null +++ b/docs/git-workflow/glossary/squash.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Объединение коммитов (Squash) + +Сведение изменений нескольких коммитов в один новый коммит. diff --git a/docs/git-workflow/glossary/version.md b/docs/git-workflow/glossary/version.md new file mode 100644 index 0000000..c73213e --- /dev/null +++ b/docs/git-workflow/glossary/version.md @@ -0,0 +1,7 @@ +--- +package: prikotov/git-workflow +--- + +# Версия (Version) + +Определённое состояние продукта, обозначенное номером, например `1.2.1`. diff --git a/docs/git-workflow/index.md b/docs/git-workflow/index.md index 8977de9..dc3e43f 100644 --- a/docs/git-workflow/index.md +++ b/docs/git-workflow/index.md @@ -11,7 +11,7 @@ package: prikotov/git-workflow - Этот файл — оглавление раздела. - Детали и правила находятся в документах по ссылкам ниже. -- [Словарь терминов (Glossary)](glossary.md) +- [Словарь терминов (Glossary)](glossary/index.md) - [Ветки (Branches)](branches.md) - [Коммиты (Commits)](commits.md) - [Pull Request (PR)](pull-request.md) diff --git a/docs/git-workflow/release.md b/docs/git-workflow/release.md index 58bf20a..6db3225 100644 --- a/docs/git-workflow/release.md +++ b/docs/git-workflow/release.md @@ -6,7 +6,7 @@ package: prikotov/git-workflow ## Модель релизов -- Для каждого [выпуска](glossary.md#release-publishing) создавайте отдельную `release/x.y.z`, включая каждый патч. Сохраняйте все релизные ветки и теги, не переиспользуйте ветку для другой версии. +- Для каждого [выпуска](glossary/release-publishing.md) создавайте отдельную `release/x.y.z`, включая каждый патч. Сохраняйте все релизные ветки и теги, не переиспользуйте ветку для другой версии. - Финализируйте обычный релиз в `release/x.y.z` от актуальной основной ветки. Коммитьте исправления и релизные файлы в неё. - Для обычного релиза направляйте запрос на слияние (Pull Request, PR) из `release/x.y.z` в основную ветку. - После проверок и одобрения слейте PR обычного релиза. Поставьте тег на проверенный коммит слияния. diff --git a/todo/done/TASK-fix-glossary-pure-md-anchors.todo.md b/todo/done/TASK-fix-glossary-pure-md-anchors.todo.md new file mode 100644 index 0000000..37467bd --- /dev/null +++ b/todo/done/TASK-fix-glossary-pure-md-anchors.todo.md @@ -0,0 +1,90 @@ +--- +type: fix +created: 2026-09-22 00:39:17 (1790037557) +due: +started: 2026-09-22 00:39:30 (1790037570) +completed: 2026-09-22 01:21:41 (1790040101) +cancelled: +value: V2 +complexity: C1 +priority: P2 +cost_plan: +cost_fact: +depends_on: +epic: +author: Бэкендер Тони (pi) +assignee: Бэкендер Тони (pi) +branch: task/glossary-pure-md-anchors +pr: https://github.com/prikotov/git-workflow/pull/12 +status: done +--- + +# TASK-fix-glossary-pure-md-anchors: Глоссарий — чистый Markdown вместо HTML-якорей + +## 0. Простое описание (Human Brief) + +### Проблема простыми словами (Problem) +- Глоссарий использует явные HTML-якоря `` (26 шт.). Валидатор ссылок `prikotov/coding-standard` такие цели не распознаёт (считает только заголовки) и ложно помечает ссылки на термины как битые. +- Владелец экосистемы принял политику чистого Markdown: якоря — только через заголовки, сырой HTML не используем. + +### Варианты или путь решения (Solution Sketch) +- Переделать глоссарий: один термин — один файл `glossary/.md` (ASCII-имя, полный двуязычный заголовок внутри), обзорный `glossary/index.md`; ссылки на термины — файлами. Автославки заголовков (`#выкладка-deployment-deploy`) и HTML-якоря отклонены владельцем как нечитаемые/сырой HTML; переименование файла прозрачно отслеживается git-ом в отличие от переименования заголовка. + +### Ожидаемый результат (Expected Result) +- В глоссарии нет сырого HTML; все внутренние ссылки пакета проходят `validate-md-links` (v0.33.0) без ложных срабатываний. + +## 1. Концепция и Цель (Concept and Goal) + +### История (User Story) +> **User Story:** Как потребитель пакета, я хочу глоссарий на чистом Markdown с якорями-заголовками, чтобы документация не зависела от сырого HTML и проходила стандартные проверки ссылок. + +### Цель по SMART (Goal) +- Заменить однофайловый глоссарий на `glossary/` из 26 файлов терминов + `index.md`; обновить все ссылки на термины (release.md, index.md, README.md, AGENTS.md); `validate-md-links` (v0.33.0) на `docs/git-workflow/` — зелёный. + +## 2. Контекст и Границы (Context and Scope) +* **Где делаем:** `docs/git-workflow/glossary.md`, `docs/git-workflow/release.md`. +* **Границы (Out of Scope):** не менять структуру секций глоссария и формулировки определений; не трогать остальные документы. + +## 3. Требования, MoSCoW (Requirements) +### 🔴 Обязательно (Must Have) +- [x] `glossary/.md` — 26 файлов терминов: front matter пакета, H1 с полным двуязычным названием, определение. +- [x] `glossary/index.md` — обзорный словарь по секциям со ссылками на термины. +- [x] Ни одного ``/`` в документах пакета; старый `glossary.md` удалён. +- [x] Ссылки на термины обновлены на файлы (`glossary/release-publishing.md`, `../pull-request.md` и т.п.). +- [x] `validate-md-links` (prikotov/coding-standard v0.33.0) на `docs/git-workflow/` — без ошибок. +### ⚫ Won't Have (Не будем делать) +- Поддержку HTML-якорей в валидаторе (отклонена политикой чистого Markdown, PR prikotov/coding-standard#126 закрыт). + +## 4. План реализации (Implementation Plan) +1. [x] Преобразовать глоссарий в H3-заголовки (первая итерация, PR #12). +2. [x] По решению владельца: переработать в файлы терминов `glossary/.md` + `index.md`. +3. [x] Обновить ссылки на термины в release.md, index.md, README.md, AGENTS.md. +4. [x] Прогнать валидатор ссылок и `composer validate --strict`. + +## 5. Критерии приёмки (Definition of Done) +- [x] 26 файлов `docs/git-workflow/glossary/.md` + `index.md`; `glossary.md` удалён. +- [x] Валидатор ссылок: все внутренние ссылки валидны. +- [x] `composer validate --strict` — valid. + +## 6. Самопроверка (Verification) +```bash +php <путь до vendor>/prikotov/coding-standard/bin/validate-md-links docs/git-workflow/ +composer validate --strict +``` + +## 7. Риски и зависимости (Rиски и Dependencies) +- Ссылки на термины теперь файловые: устойчивы к переформулировкам заголовков; переименование файла прозрачно отслеживается git. Индекс `glossary/index.md` поддерживается вручную. + +## 8. Источники (Sources) +- `docs/git-workflow/glossary.md` (до/после). +- Решение владельца: политика чистого Markdown (обсуждение в сессии task-orchestrator, PR prikotov/coding-standard#126 закрыт). + +## 9. Комментарии (Comments) + +## История изменений (Change History) +| Дата | Автор (роль) | Изменение | +| :--- | :--- | :--- | +| 2026-09-22 00:39:17 (1790037557) | Бэкендер Тони (pi) | Создание задачи | +| 2026-09-22 00:40:00 (1790037600) | Бэкендер Тони (pi) | Старт задачи, заполнение постановки | +| 2026-09-22 00:50:00 (1790038200) | Бэкендер Тони (pi) | Глоссарий переделан на H3-заголовки, ссылки обновлены, проверки зелёные | +| 2026-09-22 01:20:00 (1790040000) | Бэкендер Тони (pi) | По решению владельца переработано в файлы терминов glossary/.md + index.md; задача возвращена в review |