av
d33f37249c
- роадмап отвечает «что умеет и чего не умеет»: PLAN.md → ROADMAP.md, четыре канонические секции, достигнутые звенья строками в «Готово», цели переформулированы возможностями приложения - задачи: род работы и «Затрагивает» набору спринта, 34 заголовка в форму действия, «Завершение» целей перечнями со ссылкой из каждой задачи - вычитка проходами task-form и doc-wording, починены протухшие факты в README, паспорте и review.md
24 lines
1.7 KiB
Markdown
24 lines
1.7 KiB
Markdown
# [idea] Человеческие аннотации поверх выведенных схем
|
||
|
||
- **Секция:** Ядро
|
||
- **Зачем:** Выведенная схема говорит форму, но не смысл метрики — нужно ли описание сверху, зависит от стабильности формата
|
||
- **Теги:** goal:self-description
|
||
|
||
Схема содержимого выводится из данных и говорит **форму** — какие поля есть,
|
||
какого типа, с какой заполненностью. Чего она не говорит — что метрика значит,
|
||
в каких единицах разумны значения и чем `apple_stand_hour` отличается от
|
||
`apple_exercise_time`.
|
||
|
||
Два пути, и выбор между ними преждевременен:
|
||
|
||
- **аннотации поверх выведенных схем** — человеческое описание рядом с
|
||
машинным выводом, дописывается по мере надобности;
|
||
- **рукописный каталог метрик** — полнее, но описывал бы документацию HAE, а не
|
||
то, что он реально прислал.
|
||
|
||
Почему идея, а не задача: выбор зависит от того, насколько стабильным окажется
|
||
формат. Меняться он может только с обновлением Health Auto Export, а это
|
||
отслеживается — значит ответ придёт сам.
|
||
|
||
Связано: `docs/architecture.md` → «Самоописание», задача `derived-content-schemas`.
|