Schema Coordinates

At a glance

• Identifier: #794
• Stage: RFC2: Draft
• Champion: @magicmark
• PR: Schema Coordinates
• Related:
  • SchemaCoordinates (Schema Coordinates)

Timeline

• Added to 2025-06-26 WG agenda
• 4 commits pushed on 2025-06-25:
  • Merge branch 'graphql:main' into schema_coordinates_spec_edit by @magicmark
  • ", or {null} if no such field exists." -> "if it exists." by @magicmark
  • add non-metafield clarification by @magicmark
  • Spell check by @magicmark
• 2 commits pushed on 2025-06-06:
  • Revert "Use `::` syntax for enum values" by @magicmark
  • revert back to MemberCoordinates by @magicmark
• 2 commits pushed on 2025-06-05:
  • Use `::` syntax for enum values by @benjie
  • Merge pull request #1 from graphql/coloncolon by @magicmark
• Added to 2025-06-05 WG agenda
• Commit pushed: Update spec/Appendix B -- Grammar Summary.md on 2025-06-03 by @magicmark
• 15 commits pushed on 2025-06-02:
  • add spec updates by @magicmark
  • Add back assertion by @magicmark
  • assert that ... -> assert ... by @magicmark
  • consistent periods by @magicmark
  • consistent exists/must exist by @magicmark
  • void -> null by @magicmark
  • remove note prefix for error throwing note by @magicmark
  • Various stylistic fixes by @benjie
  • Update spec/Section 3 -- Type System.md by @magicmark
  • Update spec/Section 3 -- Type System.md by @magicmark
  • Apply benjie's suggestions from code review by @magicmark
  • split out SchemaCoordinate definition by @magicmark
  • Update spec/Section 3 -- Type System.md by @magicmark
  • condense assertion by @magicmark
  • more condensing by @magicmark
• Commit pushed: Run prettier on 2025-05-16 by @benjie
• Commit pushed: Merge branch 'main' into schema_coordinates_spec_edit on 2025-05-15 by @benjie
• 2 commits pushed on 2025-01-02:
  • Update spec/Section 3 -- Type System.md by @magicmark
  • Update spec/Section 3 -- Type System.md by @magicmark
• 4 commits pushed on 2024-12-10:
  • whitespace fix by @magicmark
  • add note about union members by @magicmark
  • prettier by @magicmark
  • formatting by @magicmark
• Added to 2021-06-03 WG agenda
• Mentioned in 2021-06-03 WG notes
• Commit pushed: Minor algo variable name refinements on 2021-04-22 by @leebyron
• 7 commits pushed on 2021-04-16:
  • update numbers by @leebyron
  • clarify element by @leebyron
  • Update Punctuator grammar by @leebyron
  • specify schema element by @leebyron
  • fix example by @leebyron
  • clarify metafields by @leebyron
  • Better Punctator by @leebyron
• Commit pushed: standalone on 2021-04-15 by @leebyron
• Commit pushed: Simplify examples on 2021-04-14 by @leebyron
• 2 commits pushed on 2021-04-13:
  • Editorial on grammar and semantics by @leebyron
  • Move section by @leebyron
• Mentioned in 2021-03-04 WG notes
• Commit pushed: Update Section 3 -- Type System.md on 2021-01-07 by @magicmark
• Added to 2021-01-07 WG agenda
• Mentioned in 2021-01-07 WG notes
• Commit pushed: - Add PR feedback on 2021-01-04 by @magicmark
• Commit pushed: enumName -> enumValueName on 2020-11-28 by @magicmark
• Commit pushed: Apply suggestions from code review on 2020-11-23 by @magicmark
• Commit pushed: Tweak example table wording on 2020-11-22 by @magicmark
• Commit pushed: implement PR suggestions on 2020-11-21 by @magicmark
• Spec PR created on 2020-11-18 by magicmark
• Commit pushed: Update schema coordinates spec edit on 2020-11-18 by @magicmark
• Commit pushed: Add Schema Coordinates RFC on 2020-09-17 by @magicmark

---

👋

I've pulled out the proposed spec edits for Schema Coordinates (issue: https://github.com/graphql/graphql-spec/issues/735) into this PR.

(The RFC now lives in the original PR: https://github.com/graphql/graphql-spec/pull/746/files)

@leebyron you mentioned it might be possible to simplify the grammar - I played around a bit since the original PR, but I think I need some help here. What did you have in mind?

As suggested, tagging @eapache @mjmahone as additional reviewers as we had some good conversation in last WG meeting about this.

Thanks!

---

GraphQL.js PR: https://github.com/graphql/graphql-js/pull/3044