Back to Plate

Slate v2 Public-Surface Reconciliation

docs/plans/2026-04-09-slate-v2-public-surface-reconciliation.md

53.0.61.6 KB
Original Source

Slate v2 Public-Surface Reconciliation

Goal

Make the current public claim explicit and internally consistent across:

  • source exports
  • package readmes
  • API docs
  • replacement envelope docs
  • roadmap/control docs

Outcome

This note captured the narrower current-claim cleanup pass that fed the later broad lane closure.

Later read:

What changed:

  • reconciled docs/api/transforms.md with the actual supported option shapes and removed stale legacy overclaim wording
  • corrected Editor.normalize(...) API docs to the real no-options signature
  • aligned the replacement envelope docs with the current normalization split
  • updated the then-live control docs around the narrower current claim
  • prepared the replacement-candidate and package docs for the later broad-lane closure

Remaining Read

This still means the current claim was made more explicit:

  • every narrowed seam is either proved or intentionally documented as narrow
  • remaining risk lives in broader contract decisions, not in silent surface drift

The later broad-lane closure is now tracked separately in: