docs: update to slug - id changes

This commit is contained in:
2026-09-27 17:04:41 +05:00
parent 7b7e12fafc
commit 8cb3f1a8f0
9 changed files with 204 additions and 164 deletions
+10 -11
View File
@@ -2,13 +2,12 @@
> Статус: **active**. Живой документ для сверки с каталогом.
>
> **Карта перечисляет `id` записи реестра (`web/src/lib/registry/`), которые
> одновременно являются адресами страниц:** `/tools/crop-png` — это
> `id: "crop-png"`. Отдельного поля `slug` в `ToolEntry` нет, поэтому id и адрес
> сейчас совпадают; их разделение — решённая, но не реализованная задача
> (`docs/backlog.md`, раздел «Мелочи всякие», и `docs/architecture.md`, раздел
> 3). Источник правды — реестр. Этот список навигационный: сверять перед
> использованием. Формат записи: `id — параметры через запятую`. Сравнение с
> **Карта перечисляет `slug` страниц (`web/src/lib/registry/pages/`) — то есть
> адреса вида `/tools/crop-png`:** это `slug: "crop-png"` у страницы, которая
> вызывает инструмент `id: "crop"`. Внутренние имена инструментов png-интента не
> держат, поэтому они от карты отделены; модель — `docs/architecture.md`,
> раздел 3. Источник правды — реестр. Этот список навигационный: сверять перед
> использованием. Формат записи: `slug — параметры через запятую`. Сравнение с
> каталогом источника (объём, нишевые клоны серий Logo*/Icon*/Stamp*Signature*)
> — замер в `docs/plan-seo.md`, §2; здесь он не дублируется.
>
@@ -20,13 +19,13 @@
## 1. Реализовано
Ids приведены к фактическим в `web/src/lib/registry/`.
Ids приведены к фактическим в `web/src/lib/registry/pages/`.
**Формат строки (проверяется тестом
`web/src/lib/registry/tools-map-doc.test.ts`):** в буллите всё **до первого
тире** `—` — это id инструментов через `/` или `,`; всё после тире — свободное
описание параметров и не разбирается. Второй id нельзя оставлять после тире,
иначе он не попадёт в разбор и инструмент будет считаться неописанным.
тире** `—` — это slug страниц через `/` или `,`; всё после тире — свободное
описание параметров и не разбирается. Второй slug нельзя оставлять после тире,
иначе он не попадёт в разбор и страница будет считаться неописанной.
### Конвертация (`convert.ts`)