fix: document safe template default editing

This commit is contained in:
James
2026-08-25 06:54:02 +00:00
parent 1e11608d44
commit 71e8e92ae9
9 changed files with 36 additions and 0 deletions
@@ -13,6 +13,10 @@ Only defaults declared in `data-composition-variables` are editable:
Keep replacement copy within 20% of the original length. The payoff logo must remain legible in the existing icon tile.
## Safe editing mechanics
Call `set_template_variable_defaults` once with the existing variable ids and their new defaults. Do not directly edit or rewrite `index.html` or its `data-composition-variables` attribute; the imported declaration is HTML-entity-encoded JSON and the setter preserves that encoding. Never edit `__template_baseline__.html` or a duplicate composition file. For the payoff logo, pass only the token returned by an image tool. Validate after the setter succeeds.
## Protected
Preserve the Slack mark on request notifications, iOS status/date/clock labels, wallpaper, notification chrome, fonts, palette, stacking geometry, scene structure, duration, timing, easing, and arrival cadence.