Forge
markdowndeeb25a2
1<a id="adr-anchors-policy"></a>
2
3### Внутренние якоря и отсылки (чтобы «см. п. N» работали как ссылки)
4
5- **Не полагаться** только на голый текст «см. п. 6 выше» — в GitHub, IDE и превью Markdown переход по **[см. п. 6](#adrNNNN-p6)** должен существовать.
6- **Идентификаторы:** для нумерованных пунктов в разделе **«Решение»** — `adrNNNN-pK`, где `NNNN` — номер ADR, `K` — номер пункта (например `adr0017-p6`). Для подпунктов при необходимости: `adr0017-p6-confirmations`.
7- **Разметка:** отдельная строка **перед** началом пункта: `<a id="adr0017-p6"></a>` (HTML допустим в CommonMark; работает в GitHub и большинстве превью). Альтернатива — заголовок `### 6. …` с явным id, если рендер поддерживает атрибуты заголовка.
8- **Кросс-ADR:** `[0017 п. 6](../0017-multi-window-workspace-and-agent-surfaces.md#adr0017-p6)` — полный путь к файлу и фрагменту.
9- **Стабильность:** при вставке нового пункта выше нумерация сдвигается — **предпочтительно** дублировать смысл в якоре по смыслу (`-confirmations`), а не только по номеру; номер в тексте обновлять вместе с пунктом.
10- Детали превью и hover — [0026](../0026-markdown-preview-surfaces-and-placement.md) (подраздел «Внутренние отсылки»).
11
View only · write via MCP/CIDE