用語集を単一YAMLで管理する

正本文書: decisions/ja/0002-single-glossary-yaml.md / 編集を提案

状態

Accepted

用語の揺れは思想の揺れにつながる。特に多言語化する場合、言語ごとに用語集を分けると整合性が崩れやすい。

World Foundation Designでは、自由参加、離脱可能性、フォーク可能性、腐敗耐性、対象外、脅威モデルなど、意味のずれが安全性に直結する用語を扱う。

用語集は言語別に分けず、glossary/terms.yml で一元管理する。

表形式化、自動処理、多言語展開、翻訳整合性、レビューのしやすさを優先する。

同じIDに日本語と英語を置くことで、用語追加や定義変更のレビュー範囲を明確にする。

用語追加時はYAMLを更新する。重要用語の変更は意思決定へ記録する。

YAML構文を壊すと用語集全体の利用に影響するため、重複IDと構文の確認を行う。