Skip to content

Conversation

@sarahxsanders
Copy link
Contributor

@sarahxsanders sarahxsanders commented Dec 26, 2025

Description

adds a new guide for the "schema governance" series on graphql.org/learn Includes new guide: Establish naming conventions and design standards:

  • Field and type naming patterns
  • Boolean field prefixes
  • Mutation naming strategies
  • Input/output type suffixes
  • Nullability patterns and null bubbling behavior
  • Schema documentation best practices
  • Custom scalars for domain-specific types
  • Error handling approaches
  • Pagination with Relay connections
  • Schema linting with GraphQL-ESLint
  • CI/CD validation pipeline examples
  • Common anti-patterns to avoid

PLEASE DO NOT MERGE, THIS IS PART OF A SERIES OF GUIDES ON SCHEMA GOVERNANCE. THERE ARE TWO MORE GUIDES TO FOLLOW

Note: this needs heavy technical review - the content is based on heavy research i did, but since there's no strict naming conventions/guidance defined in the schema we will want to proceed with confidence that everything here is guidance we want to put out there!

@vercel
Copy link

vercel bot commented Dec 26, 2025

@sarahxsanders is attempting to deploy a commit to the The GraphQL Foundation Team on Vercel.

A member of the Team first needs to authorize it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant