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