Schema Design: Be explicit with descriptions

まだ誰も着手していません。

Provide comprehensive context in descriptions, including clear definitions. Avoid team-specific acronyms, describe all enum values, and link to authoritative sources where relevant.

Rationale: Future developers should be able to understand schema elements using only the provided documentation. Include what a concept is, why it matters, where to find additional information, and concrete examples for enum options.

まず graphql.github.io コードベース内のスキーマ定義を見つけ、現在その説明がどのように記述されているかを確認します。説明にコンテキストと明確な定義があり、チーム固有の頭字語を避け、すべての enum 値を文書化し、関連する場合は信頼できる情報源にリンクし、目的、追加情報への参照、具体例を含んでいれば完了です。

索引モデルが issue の本文から書いたものです。