Skip to content

Conversation

@jwaldrip
Copy link

Summary

  • Add description field to operations (query, mutation, subscription)
  • Add description field to named fragments
  • Update parser to accept descriptions before operations and fragments
  • Update SDL rendering to include descriptions

This implements the Document Descriptions feature from the GraphQL September 2025 specification, allowing descriptions to be added to operations and fragments in GraphQL documents.

Test plan

  • Added comprehensive tests for document descriptions (26 new tests)
  • All 1468 tests pass
  • Verified parser accepts descriptions before operations and fragments
  • Verified SDL rendering includes descriptions

🤖 Generated with Claude Code

Implements the GraphQL September 2025 specification feature that allows
descriptions on executable definitions (operations and fragments).

Changes:
- Add `description` field to Blueprint.Document.Operation struct
- Add `description` field to Blueprint.Document.Fragment.Named struct
- Add `description` field to Language.OperationDefinition struct
- Add `description` field to Language.Fragment struct
- Update parser to accept descriptions before operations and fragments
- Update Blueprint.Draft conversion to preserve descriptions
- Update SDL rendering to output descriptions for operations/fragments
- Add comprehensive tests for the new functionality

Specification: https://spec.graphql.org/September2025/#sec-Descriptions
Reference: RFC absinthe-graphql#1170

Co-Authored-By: Claude Opus 4.5 <[email protected]>
@jwaldrip jwaldrip force-pushed the feat/document-descriptions branch from 56f8551 to 65ce8cc Compare January 13, 2026 15:17
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