Skip to content

[Website] Add "Opt-In Features" blog post - #10373

Open
glen-84 wants to merge 2 commits into
mainfrom
gai/opt-in-features-blog-post
Open

[Website] Add "Opt-In Features" blog post#10373
glen-84 wants to merge 2 commits into
mainfrom
gai/opt-in-features-blog-post

Conversation

@glen-84

@glen-84 glen-84 commented Sep 8, 2026

Copy link
Copy Markdown
Member

Summary

  • Adds a blog post on opt-in features and the @requiresOptIn directive: its Kotlin origins and the Stage 0 GraphQL RFC, how it pairs with @deprecated to complete the feature lifecycle, and how to use it in Hot Chocolate and Fusion.
  • Covers all five directive locations, the includeOptIn, requiresOptIn, optInFeatures, and optInFeatureStability introspection surface, stability levels, and Fusion's union merge and OPT_IN_FEATURE_STABILITY_MISMATCH rule.

The frontmatter references a header.png that is not part of this PR yet. The image needs to be added under website/public/images/blog/2026-09-08-opt-in-features/ before the post is published.

Copilot AI lite review requested due to automatic review settings September 8, 2026 16:02

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.

🟡 Changes recommended

The post references a featuredImage (header.png) that is not present under the expected public blog image directory, which will render a broken header image.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Adds a new website blog post explaining GraphQL opt-in features via the @requiresOptIn directive, including background, usage in Hot Chocolate, and behavior in Fusion composition/introspection.

Changes:

  • Adds a new blog post covering the @requiresOptIn directive and the opt-in feature lifecycle alongside @deprecated.
  • Documents usage patterns (implementation-first, code-first, schema-first) plus introspection and stability metadata.
  • Explains Fusion composition semantics and the OPT_IN_FEATURE_STABILITY_MISMATCH rule.
File summaries
File Description
website/content/blog/2026-09-08-opt-in-features.md New blog post content and frontmatter for the “Opt-In Features” article.
Review details
  • Files reviewed: 1/1 changed files
  • Comments generated: 1
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread website/content/blog/2026-09-08-opt-in-features.md
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.

2 participants