Skip to content

Wandas X.Y.Z

Use this source template for a feature release or any release containing a compatibility change, then remove guidance that does not apply. An ordinary patch release with no compatibility change may state that none occurred without copying the full table. The public API stability policy describes the user-facing guarantee; this template records the maintainer's classification, migration, and any approved exception for a specific release.

Use these classifications when completing the table:

  • Stable: documented public API or behavior that users may rely on.
  • Experimental: explicitly marked provisional API or behavior.
  • Serialized: WDF, Recipe, or another persisted schema contract.
  • Internal-only: implementation detail with no supported user-facing contract.

For stable and serialized changes, record the deprecation start and replacement; an exception requires a linked decision. Record the removal or semantic-change version, and state the migration or why no migration applies.

Highlights

  • Describe the release outcome.

Changes

  • Link each included pull request.

Compatibility

For every removal or incompatible semantic change, complete one row. Stable and supported serialized contracts may use None only when the linked decision explicitly approves an exception. Experimental removals may use None without an exception because they do not require a warning release; still record their classification, migration, and change version. Use Not applicable for an internal-only deprecation field.

Affected surface or artifact Classification Deprecation start Replacement or migration Removal/change version Exception reason and decision link
name Stable / Experimental / Serialized / Internal-only X.Y.Z or None replacement X.Y.Z Not applicable or reason + decision link

State explicitly when the release contains no compatibility changes.