Schema Coordinates

At a glance

• Identifier: #794
• Stage: RFC 3 / Accepted
• Champion: @magicmark
• Latest activity: 5 commits pushed on 2025-09-01
• Spec PR: https://github.com/graphql/graphql-spec/pull/794
• Related:
  • #735
  • #746

Spec PR description

👋

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

Timeline

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