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