Release Activities

This is the list of release activities needed for every TypeScript release. Additional activities are also needed if a new syntax is introduced or a new compiler option gets added.

Release Candidate Activities

definitelytyped-header-parser and dt-retag

Once master's version is updated, surrounding projects must be aware of the nightlies so that functionality such as ATA continues to work.

• Update definitelytyped-header-parser to understand the next version, and publish new version
  • in other words, if we're releasing TypeScript 3.2, the header parser needs to be able to parse 3.3.
• Update dt-retag to the new header-parser and run it to add the tag for typescript@next to each package.

Release Activities

Release

• Tag release branch
• Update AUTHORS.md for the release (script)
• Draft and publish new release
• Close milestone corresponding to the release

Wiki

• Update What's new in TypeScript
• Update Breaking Changes
• Update API Breaking Changes

Handbook

• Add new Release Notes page for the new release
• Update Handbook (As needed)

npm

• Publish new version of typescript
• Publish new version of tslib (if needed) by creating a tag

Nuget

• Publish new release to https://www.nuget.org/packages/Microsoft.TypeScript.MSBuild/

Visual Studio Marketplace

• Publish VS 2015 and VS 2017 installers under TypeScript team

TypeScript-Sublime-Plugin

• Update version of tsserver, test, and tag

dtslint and types-publisher

After the release version is published to npm:

• Update dtslint's dependency to the new header-parser
• Update types-publisher's dependency on dtslint. Be sure to clear caches on Travis since it doesn't know how to cache github dependencies correctly.
• Run dt-retag again so that packages published during the RC period get the new version's tag.

Website

• Update Handbook
• Add new release notes page
• Update playground
• Update version strings in the download banner

Additional activities

When a new syntax or a new compiler option is introduced, find below the list of additional release activities needed:

New compiler option added

MSBuild tasks and targets

• Add support for new option in MSBuild tasks and targets (see handbook)

Handbook

• Add new option to Compiler Options
• Add new option to Compiler Options in MSBuild

SchemaStore

• Add new option to tsconfig.json schema
• Add new option to jsconfig.json schema

New syntax introduced

Colorization

• Add colorization support in TypeScript-TmLanguage

Babel

• Add parsing support in Babylon
• Add emit support to babel-plugin-syntax-typescript
• Update the TypeScript-Babel-Starter as needed

Handbook

• Add new section for the new feature in the handbook