一目でのステージ
vocabulary match 列が鍵です: 仕様ステージとスキーマ注釈は同じ状態の 2 つのビューです。
static/schemas/source/ の JSON Schema が "x-status": "experimental" を持つなら、それが属するセクションは Proposed ステージにあります。x-status マーカーを持たず、スキーマが GA リリースで出荷されているなら、Final ステージにあります。
ステージ定義
Draft
セクションは、ワーキンググループが GitHub マイルストーンでスコープされた提案 — 定義されたスコープを持つspec / protocol ラベル付き issue — を開いたが、まだ static/schemas/source/ にスキーマが公開されていないとき Draft にあります。Draft セクション:
- いかなる種類の安定性コントラクトも運ばない。Draft セクションに対して進むビルダーは自己責任でそうし、変更のため該当する GitHub マイルストーンを追跡すべき（SHOULD）。
get_adcp_capabilitiesで宣言されない。セラーは Draft セクションとの適合性を主張できない。- Proposed に達する前に放棄されることがある。
Proposed
セクションは、そのスキーマがスキーマルートまたは特定のプロパティに"x-status": "experimental" を持って static/schemas/source/ に存在し、かつ それを実装するセラーが get_adcp_capabilities の experimental_features に機能 id を宣言するとき Proposed です。
完全な Proposed ステージのコントラクト — 6 週間予告で変わりうるもの、変わらないもの（認証、トランスポート、エラーエンベロープ）、セラー宣言要件を含む — は 実験的ステータス で仕様化されています。そのページが統治します。このページはステージ語彙をそれにマップします。
参入: スキーマが x-status: experimental を持って 3.x リリースで公開される。リリースに伴うアーキテクチャ委員会レビューが実験的ステータスを確認する。
決定権限: アーキテクチャ委員会、リリース時。
Final
セクションは、そのスキーマが安定 — アーキテクチャ委員会がレビューした意図的な卒業 PR 経由でx-status: experimental が削除された — とき Final です。
4 つの卒業基準は 実験的ステータス — 安定版への卒業 で仕様化されています — 本番シグナル要件、クロスパーティ検証ハードル（45 日以上稼働しうち少なくとも 1 つが本番の 2 番目の実装、または 1 実装 + バイヤー統合）、スキーマ安定性ウィンドウ、意図的な昇格 PR を含む。そのページが統治します。このページはステージ語彙をそれにマップします。アーキテクチャ委員会は各 3.x リリースで卒業 PR をレビューします。
いったん Final になると、セクションは完全な 3.x 安定性保証 によって保護されます: フィールドは決して削除されず、enum は加算的のみ、タスク名はメジャーバージョン内で決して削除もリネームもされません。3.x の Final セクションは、4.0 開発サイクルを通じて — 同じ保証の下で — Final のままです。 アクティブな 4.0 スコーピング下のセクションは遡及的に降格されません。3.x コントラクトは 3.x サポートが終わるまで保たれます。前メジャーのサポートウィンドウ を参照。
参入: experimental-status.mdx の 4 つの卒業基準すべてが満たされる。アーキテクチャ委員会が承認し、スケジュールされた 3.x リリースで卒業 PR をマージする。
決定権限: アーキテクチャ委員会。
Deprecated
セクションは、正式な非推奨予告がリリースノートとチェンジログで公開され、削除への 6 か月のカウントダウンが始まったとき Deprecated です。セクションは非推奨ウィンドウ中、完全に機能し 3.x 安定性保証の下にあります。 非推奨ポリシー — 6 か月の最小予告、非推奨化後少なくとも 1 つの完全なリリースサイクル機能が持続、同じメジャーバージョン内で決して削除されない — は バージョニング — 非推奨ポリシー で仕様化されています。 参入: 非推奨予告が 3.x リリースのリリースノートとチェンジログに着地する。置き換え（あれば）が同じリリースで出荷される。アーキテクチャ委員会が削除ターゲット（常にメジャーバージョン境界）を確認する。 決定権限: アーキテクチャ委員会、ワーキンググループレビューを伴う。 アナウンス:deprecated ラベル + 移行ノート付きのリリースノートエントリ、チェンジログエントリ、スキーマのインライン @deprecated 注釈。
Sunset
セクションは、それがターゲットにされたメジャーバージョン境界が出荷されたら Sunset（削除）です。ポリシーにより、Deprecated セクションは同じメジャーバージョン内で決して削除されません — 最も早い削除日は次のメジャーの GA です。v2 サンセットタイムラインは v2 sunset ページ で文書化されています。 参入: 後継メジャーが GA 出荷される。以前に非推奨化されたフィールド、タスク、スキーマプロパティが新しいメジャーのスキーマから省略される。 決定権限: 暗黙 — メジャーバージョンリリースプロセスが削除を運ぶ。遷移図
仕様セクションの現在のステージを確認する方法
- スキーマmarker:
static/schemas/source/の該当スキーマを確認。"x-status": "experimental"→ Proposed。出荷されたスキーマにマーカーなし → Final。static/schemas/source/にないがオープンな GitHub マイルストーン issue で参照 → Draft。 - 実験的サーフェスリスト: 実験的ステータス ページが、機能 id と現在のステータスを持つすべての現在 Proposed のサーフェスをリストする。
- GitHub マイルストーン: アクティブなマイルストーンのオープン issue は Draft と Proposed の作業を表す。マージされたスキーマに
x-statusのない出荷済みアイテムは Final。 - リリースノート: Deprecated セクションは、すべてのリリースのノートで
deprecatedラベルと削除ターゲット付きで言及される。
ワーキンググループとガバナンス
誰がワーキンググループに座るか、投票しきい値、定足数、エスカレーションパスを統治する手続き:- RFC プロセス（#2437）: 提案テンプレート、決定記録形式、RFC から仕様変更までのライフサイクル
- ワーキンググループ憲章（#2438）: 定足数、投票しきい値、名簿、忌避ポリシー — アクティブに開発中