Stable platform-spec URLs across releases

Platform spec ADR

Stable platform-spec URLs across releases

Back to Release and versioning policy ◎ Open feature in platform map

Spec standingStandard

Owner

Piotr Mikstacki pmikstacki@cybernomad.it

Submitter

Piotr Mikstacki pmikstacki@cybernomad.it

Current document

Articles

• No directly attached article pages for this node.

History

0 revisions (git unavailable at build; counts may be empty)

Open full history on GitHub

No commits recorded for this path.

Completeness

OKfeature · 0 SpecSection(s) · 5 H2 heading(s)

Section id	Required	Found
what-this-feature-specifies	no	no
implementation-anchors	no	no

Full tree: run pnpm verify:platform-spec-layout (writes src/generated/platform-spec-layout-report.json).

Related spec docs

• Feature
  Release and versioning policy

  Parent feature hub

Context

Renaming or version-prefixing feature paths broke bookmarks and relatedTopics links across domains.

Decision

Feature and language-meta paths must remain stable across releases. Behavioral change is expressed by editing normative text and metadata (status, lastReviewed, embedded decisions), not by introducing version segments in site paths.

Consequences

Redirects handle legacy Starlight paths; normative slugs under platform-spec/ stay fixed.

Verification anchors

site/website Astro routes; platform-spec nav tree generation.