Skip to content

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

Draft
glen-84 wants to merge 4 commits into
mainfrom
gai/directives-on-directive-definitions-blog
Draft

Add "Directives All the Way Down" blog post#10062
glen-84 wants to merge 4 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
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.

3 participants