WORK-426
Setting up your dashboard 0 entities found · 8/33 branches scanned
ID:WORK-426Status:pending

Migration + docs for the surface axes

Land the breaking elevation rename safely and bring the site + docs onto the new vocabulary (SPEC-107 §5).

Priority:mediumComplexity:moderateMilestone:v0.23.0Source:SPEC-107

Criteria completion

Criteria completion: 0 of 3 (0%) checked; tracking started on Jun 14, no incremental history yet0%25%50%75%100%Jun 14Jun 15

Tracking started Jun 14 — check back for trends.

Scope

  • A refrakt-side codemod that rewrites authored elevation="none|sm|md|lg" in content to the new values (noneflat, sm/mdraised, lgfloating); run it across the site. Scope it to the elevation attribute onlyframe-shadow carries the identical none/sm/md/lg values and must not be touched (SPEC-107 §1).
  • Rewrite surfaces.md (the canonical surfaces reference) around the three axes — including the two-layer model (surface axes elevation/prominence vs the layout axis width) and the elevationframe-shadow boundary; migrate the elevation= usages in figure.md, card.md, bento.md; update extend/theme-authoring/dimensions (and any reference to the old named scale).
  • Add a changeset documenting the breaking change + the alias deprecation window. Leave releases.md (historical) untouched.

Acceptance Criteria

  • A codemod migrates elevation values in content; the site has no remaining none|sm|md|lg elevation usages. Authored frame-shadow="none|sm|md|lg" is left untouched.
  • surfaces.md documents elevation (ladder), width (bleed), and prominence (family) accurately; figure/card/bento examples use the new values.
  • A changeset records the breaking change and the deprecation window.

Dependencies

  • Requires WORK-423 (aliases to migrate from) and WORK-425 (final vocabulary in the theme).

References

  • SPEC-107 · site/content/runes/surfaces.md · site/content/extend/theme-authoring/dimensions.md.