graphql / graphql/graphql.github.io

Add more GraphQL Schema Design Guidlines

オープン
#2,353 コメント 0 件 リアクション 1 件 担当者 0 名 GitHub で見る
主要言語
TypeScript
スター
889
フォーク
1.5k
平均マージ
4日 12時間
マージ済み PR(30日)
21

説明

We have a page for Schema Design https://graphql.org/learn/schema-design/

I think we should add lots more entries to this page!

There's lots of well-established principles and conventions already, see https://github.com/magicmark/awesome-graphql-schema-design

Not everything is universally applicable. We should seek to only upstream things that make sense to 99% of users, or add clarification statements for things that are less universally true but still largely true.

For any non-trivial additions, I would propose we review PRs either in the main wg or golden path wg (cc @benjie) meetings?

Let's create sub-issues for each topic.

_(This ticket is being made as an action item from Golden Path WG Mar 12th 2026)_

コントリビューションガイド

コントリビューションガイドを開く

調査の方向性

graphql.org/learn/schema-design/ にある既存の Schema Design ページから始め、参照されている awesome-graphql-schema-design リストと比較してください。大まかな依頼をトピックごとの sub-issue に分割し、各追加項目について、その範囲と適用可能性について合意し、関連する PR のレビューが完了してから初めて完了とみなしてください。

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

評価

技術スタック
graphql
領域
api, documentation
issue の種類
ドキュメント
難易度
5/5
見積もり時間
1週間以上
活発さ
停滞
明瞭さ
説明が足りない
初心者へのやさしさ
25/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。