Phase tags¶
Each doc may carry one or more phase tags in its YAML frontmatter to indicate where the documented behavior fits in the project's release timeline.
Controlled vocabulary¶
Only two tags are allowed today:
| Tag | Meaning |
|---|---|
Launch |
The end-state we're designing toward. Most prescriptive specs in this repo describe Launch behavior. |
Current |
The behavior actually shipped today. May be a subset of Launch, or may diverge while implementation catches up. |
A doc tagged only Launch describes the target. A doc tagged only Current describes shipped behavior. A doc tagged both means the Launch spec is fully implemented today.
When Launch and Current need to diverge (e.g., terraforming, where the formula model changed deliberately, or warp gates, where the construction pipeline is design-only), we may split a single page into a Launch end-state file and a Current shipped-state file rather than juggling both in one doc.
How to use the filter¶
Click any tag chip below or at the top of a tagged page to see every doc carrying that tag. Use the search bar to combine a tag with a keyword.
Adding a tag¶
In any markdown file, add YAML frontmatter at the very top:
---
tags:
- Launch
---
Multiple tags are allowed:
---
tags:
- Launch
- Current
---
Stick to the controlled vocabulary above. New tags require team agreement and an update to this page.