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

Общие ресурсы экосистемы — 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.md) — UI-ресурс (gnexus-ui-kit) и его дока
- [git.md](git.md) — репозитории проектов и правила коммитов
- [../30-operations/docs.md](../30-operations/docs.md) — что документируется в gnexus-book