Skip to content

docs: complete v2.0 migration guide and add announcement blog post#1808

Open
jziggas wants to merge 4 commits intoMichalLytek:masterfrom
jziggas:docs/v2-migration-guide-and-blog-post
Open

docs: complete v2.0 migration guide and add announcement blog post#1808
jziggas wants to merge 4 commits intoMichalLytek:masterfrom
jziggas:docs/v2-migration-guide-and-blog-post

Conversation

@jziggas
Copy link
Copy Markdown
Contributor

@jziggas jziggas commented Mar 26, 2026

Summary

  • Expands the migration guide (docs/migration-guide.md) to cover all breaking changes from v1.x to v2.0 — resolver loading, auth system, validation, error classes, scalars, custom decorators, deprecated options, nullability, build target, ESM, and peer dependencies. Each section includes before/after code examples.
  • Adds an announcement blog post (website/blog/2026-03-26-typegraphql-2.md) for the v2.0 stable release, covering the major features and linking to the migration guide.

Closes #1418

Test plan

  • Review migration guide sections against CHANGELOG.md breaking changes for completeness
  • Verify code examples match current API (types, signatures, imports)
  • Run npm run build in website/ to confirm Docusaurus builds cleanly
  • Check blog post renders correctly in local dev server

Open with Devin

Expand migration guide to cover all breaking changes from v1.x to v2.0
(resolver loading, auth, validation, errors, scalars, custom decorators,
deprecated options, nullability, build target, ESM, peer deps).

Add announcement blog post for the v2.0 stable release.

Closes MichalLytek#1418

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copy link
Copy Markdown

@devin-ai-integration devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

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

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

Open in Devin Review

…migration guide

Add "Other improvements" section to blog post covering non-breaking
features: directives on interfaces/args, deprecating input fields,
buildTypeDefsAndResolversSync, readonly auth roles, default value
inference opt-out, implements chain relaxation, Reflect polyfill support.

Add note about graphql-js v15 to v16 upgrade in migration guide peer
dependencies section.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
devin-ai-integration[bot]

This comment was marked as resolved.

Co-authored-by: devin-ai-integration[bot] <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Comment thread website/blog/2026-03-26-typegraphql-2.md Outdated
@MichalLytek
Copy link
Copy Markdown
Owner

Love it! ❤️ Thank you very much for your contribution 🙌

Replace the brief bullet list with a proper performance chapter covering:
- HashMap-based metadata caching (O(n) to O(1) for 11 metadata categories)
- Validation becoming opt-in (skipping entire middleware layer)
- Glob path removal (no more dynamic require at build time)
- Safe multi-schema builds (cloned metadata storage per build)
- ES2021 target and graphql-js v16 improvements

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@jziggas
Copy link
Copy Markdown
Contributor Author

jziggas commented Apr 6, 2026

@MichalLytek How is this?

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.

Towards TypeGraphQL v2.0

2 participants