docs: документация переведена на канон av-dev-pm
- беклог и план переехали в docs/tasks (38 задач, 11 целей), слаги переименованы с транслита на английские, 85 ссылок поправлены - conventions.md разобран в docs/conventions/, local-research.md — в docs/research/, review-journal.md — в docs/review.md с разделом настройки конвейера; заведены security.md, adr/ и .pm.json - шаг docs.py check добавлен в task gate; поведение в architecture.md помечено девятью маркерами долга, database.md получил настройки с числовым значением
This commit is contained in:
@@ -0,0 +1,21 @@
|
||||
# [idea] Человеческие аннотации поверх выведенных схем
|
||||
|
||||
**Секция:** ядро · **Хук:** Выведенная схема говорит форму, но не смысл метрики — нужно ли описание сверху, зависит от стабильности формата · **Теги:** goal:self-description
|
||||
|
||||
Схема содержимого выводится из данных и говорит **форму** — какие поля есть,
|
||||
какого типа, с какой заполненностью. Чего она не говорит — что метрика значит,
|
||||
в каких единицах разумны значения и чем `apple_stand_hour` отличается от
|
||||
`apple_exercise_time`.
|
||||
|
||||
Два пути, и выбор между ними преждевременен:
|
||||
|
||||
- **аннотации поверх выведенных схем** — человеческое описание рядом с
|
||||
машинным выводом, дописывается по мере надобности;
|
||||
- **рукописный каталог метрик** — полнее, но описывал бы документацию HAE, а не
|
||||
то, что он реально прислал.
|
||||
|
||||
Почему идея, а не задача: выбор зависит от того, насколько стабильным окажется
|
||||
формат. Меняться он может только с обновлением Health Auto Export, а это
|
||||
отслеживается — значит ответ придёт сам.
|
||||
|
||||
Связано: `docs/architecture.md` → «Самоописание», задача `derived-content-schemas`.
|
||||
Reference in New Issue
Block a user