16.0.0 Release plan

Goals

Convert source code to idiomatic TypeScript
Remove Flow-specific workarounds and pre-ES6 JS artifacts
Support Deno
Support ESM
Switch master to main.

Planned breaking changes

Legacy SDL syntax (deprecated 2year ago) and other deprecated APIs and flags
Drop native IE support by removing built-in polyfills and switching the output to ES6. It would be still possible to support IE with core-js + babel.
Drop TS before 3.7 since we need to support recursive types.
Maybe we will have some unexpected breaking changes to TS types due to migration

Post 16.0.0 goals

Convert test suite to Jest
Experiment with TS types to provide better typings for resolvers

P.S. We need to target 04/31/2021 for 17.0.0 release at that point we need to do a breaking release anyway to drop Node v10.

Steps

1. Branch out 15.x.x release line and release 15.5.0 (Jan 8th)
2. Switch master to main and update scripts & CI
3. Move commits from https://github.com/graphql/graphql-js/tree/16.x.x to main
4. Remove last few polyfills
4. Release 16.0.0-alpha.1 with all expected breaking changes but still from Flow sources (~~Jan 12th~~)
5. Rebase #2828 and merge it (no squash, keep separate commits) (~~Jan 15th~~)
6. Fix tests, CI, and release scripts but disable tsc and TS-specific ESLint checks (~~Jan 18th~~)
7. Mark tsc errors with @ts-ignore and fix them in separate PRs by volunteers
8. Enable TS-specific ESLint rules in separate PRs by volunteers
9. Release new 16.0.0-alpha.3 and gather feedback (finish until Feb WG)
10. Work on ESM and Deno support in parallel
11. Release 16.0.0-rc.1 and gather feedback
12. Generate basic docs with tsdoc
13. Release 16.0.0 🎉
14. Wait couple weeks and gather feedback.
15. Switch main to the 17.0.0-alpha.0 branch and have a setup that will automatically release package after every merge.
16. Start accepting breaking/experimental PRs for 17.0.0.

How I can help?

Review #2828 with basic TS conversion. It’s split into multiple commits that are easy to review: https://github.com/graphql/graphql-js/pull/2828/commits
Wait for #2828 to be merged and help with latter steps.

Issue Analytics

State:
Created 3 years ago
Reactions:37
Comments:13 (10 by maintainers)

Top GitHub Comments

20reactions

IvanGoncharovcommented, Oct 28, 2021

Released https://github.com/graphql/graphql-js/releases/tag/v16.0.0

6reactions

robrichardcommented, Jun 3, 2021

@acao I believe the plan is for defer-stream & asynciterable to be incorporated into main once it starts targeting 17.0.0-alpha.x

Top Results From Across the Web

LLVM 16.0.0git Release Notes - Documentation

These are in-progress notes for the upcoming LLVM 16 release. Release notes for previous releases can be found on the Download Page.

Visual Studio 2019 build numbers and release dates

Version Release Date Build Number Links to Installers Notes 16.11.22 December 13, 2022 16.11.33130.400 Enterprise Professional BuildTools Releas... 16.11.21 November 8, 2022 16.11.33027.164 Enterprise Professional...

Release Notes: BIG-IP 16.0.0 New and Installation - AskF5

These release notes document the BIG-IP version 16.0.x releases. You can apply the software upgrade to systems running software version ...

Clarity Release Notes - TechDocs - Broadcom Inc.

Release Notes help you plan for a new installation or upgrade to the ... the roadmap items with the associated Clarity investment.

16.0.0 Release Notes (Dremio April 2021)

Dremio 16.0.0 provides administrators a more extensive range of privileges to control ... which allows for improved optmization of query execution plans.