Обратная связь в общие ресурсы

Общие ресурсы экосистемы — gnexus-ui-kit, клиентские библиотеки (gnexus-auth-client-py, gn-synapse-client-*), сервисы-хабы (gnexus-auth, Synapse), а также контракты, форматы и протоколы между сервисами — живут в своих репозиториях. Проблема, найденная потребителем, не должна оставаться только в потребителе: из следующего сервиса её найдут заново.

Правило

Найден нюанс, несовершенство, баг или недоработка в общем ресурсе — либо есть толковое предложение по улучшению (в том числе по контракту, протоколу, формату обмена) — запись об этом делается в проекте самого ресурса, в его документации, в подходящем файле.

У себя (в сервисе-потребителе) — только рабочий обход и короткая пометка со ссылкой на запись в ресурсе: почему код написан неочевидно, когда обход можно снять.

Что указать в записи

Источник — где нашлось: сервис-потребитель, файл/экран/класс, а также версия или коммит ресурса, на котором воспроизводится.
Автор находки — кто нашёл: человек или ИИ-агент.
Автор задачи — по чьей постановке шла работа, при которой нашлось (владелец, задача в трекере): по этому следу восстанавливается контекст обнаружения.
Дата записи.
Суть — симптом и ожидаемое поведение; для бага — шаги воспроизведения.
Доказательства — замеры, скриншоты, вывод команд: без них находку невозможно ни подтвердить, ни закрыть.
Предложение по исправлению — если есть; оно может быть отклонено, но должно быть видно автору ресурса.
Ссылка на задачу в трекере ресурса — если она заведена (например, запись в проекте ресурса в gntodo); задача и запись ссылаются друг на друга.

Куда именно

Есть подходящий раздел (подводные камни, known issues, ограничения, changelog) — запись идёт туда.
Нет — заводится отдельный документ в доке ресурса, на который ссылается его README.
Исправление уже сделано — запись превращается в строку changelog/релиза, а не удаляется: потребители должны узнать, что обход можно снять.

Пример

## Иконка .ph.normalize уезжает под базовую линию во флекс-строке
Источник: gntodo, подвал карточки проекта; ui-kit 1.0.0 (коммит e28f382).
Автор находки: ИИ-агент (сессия разработки gntodo). Автор задачи: владелец, веха 0.83.
Дата: 2026-10-10. Задача: GNtodo #241.
Суть: `.ph.normalize{position:relative;top:.15em}` верен для инлайновой строки, но в
флекс-строке (`align-items:center`) опускает глиф на 0.135em ≈ 1.6px ниже базовой линии.
Замер (чернила в скриншоте): с поправкой центр глифа на 1.3px ниже центра цифры, без — 0.2px выше.
Предложение: `vertical-align: -0.15em` вместо `position:relative; top` (на флекс-элемент
`vertical-align` не действует вовсе) либо отдельный класс без поправки.

Ссылки

ui.md — UI-ресурс (gnexus-ui-kit) и его дока
git.md — репозитории проектов и правила коммитов
../30-operations/docs.md — что документируется в gnexus-book