Skip to content

Add "Directives All the Way Down" blog post - #10062

Merged
michaelstaib merged 6 commits into
mainfrom
gai/directives-on-directive-definitions-blog
Aug 3, 2026
Merged

Add "Directives All the Way Down" blog post#10062
michaelstaib merged 6 commits into
mainfrom
gai/directives-on-directive-definitions-blog

Conversation

@glen-84

@glen-84 glen-84 commented Jul 7, 2026

Copy link
Copy Markdown
Member

Summary

  • New blog post announcing directives on directive definitions, landing in Hot Chocolate 16.4: the one GraphQL location directives could never target (a directive definition itself) is now open.
  • Walks through a light spec history (graphql-spec #1206), the SDL, implementation-first, and code-first APIs, deprecating a directive with @deprecated, and the introspection surface (__Directive.isDeprecated/deprecationReason, __Schema.directives(includeDeprecated:)).
  • Covers non-deprecation uses (@requiresOptIn, @tag, bring-your-own metadata directives) and closes by inviting reader use cases.

(Pure content addition, so no test plan.)

Copilot AI review requested due to automatic review settings July 7, 2026 13:46

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new website blog post announcing Hot Chocolate 16.4 support for applying directives to directive definitions (“directives all the way down”), including examples for SDL, implementation-first, and code-first, plus introspection and non-deprecation use cases.

Changes:

  • Adds a new blog post explaining the GraphQL spec change (DIRECTIVE_DEFINITION) and Hot Chocolate 16.4 support.
  • Includes practical examples for deprecating directives and reading the new introspection fields/arguments.
  • Links readers to the corresponding docs section for full reference.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +4 to +6
description: "GraphQL directives can now be applied to directive definitions themselves in Hot Chocolate 16.4, so you can finally deprecate a directive and attach metadata to your schema's own extension points."
tags: ["hotchocolate", "graphql", "directives", "deprecation"]
featuredImage: "header.png"
Comment thread website/content/blog/2026-07-07-directives-all-the-way-down.md Outdated
@glen-84
glen-84 marked this pull request as draft July 7, 2026 14:20
@michaelstaib
michaelstaib marked this pull request as ready for review August 3, 2026 14:25
@michaelstaib
michaelstaib merged commit e5b52c9 into main Aug 3, 2026
145 of 147 checks passed
@michaelstaib
michaelstaib deleted the gai/directives-on-directive-definitions-blog branch August 3, 2026 14:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants