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.

Commencez par localiser les définitions du schéma dans la base de code graphql.github.io et examinez la manière dont leurs descriptions sont actuellement rédigées. Le travail est considéré comme terminé lorsque les descriptions fournissent du contexte et des définitions claires, évitent les acronymes propres à l’équipe, documentent chaque valeur de l’enum, renvoient vers des sources faisant autorité lorsque cela est pertinent et incluent l’objectif, des indications vers des informations supplémentaires et des exemples concrets.