29 Release Activities

Gabriela Araujo Britto редактировал(а) эту страницу 2024-08-22 10:51:07 -07:00

Содержание

• Release Candidate Activities
• tslib
• @definitelytyped/typescript-versions and @definitelytyped/typescript-packages
• Release Activities
• Release
• Project Health
• Wiki
• Handbook
• npm
• Nuget
• Visual Studio Marketplace
• TypeScript-Sublime-Plugin
• dtslint and types-publisher
• Website
• Additional activities
• New compiler option added
• MSBuild tasks and targets
• New syntax introduced
• Colorization
• Babel
• Handbook

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.

The primary people managing a release should oversee these tasks along with the overall release process.

Release Candidate Activities

tslib

• Add all tslib updates
• Review next version number

@definitelytyped/typescript-versions and @definitelytyped/typescript-packages

Once main's version is updated, the @definitelytyped packages must be aware of the nightly's new version so that nightly versions of ATA continue to work. ATA relies on tsX.Y tags on @types/* packages.

• Update @definitelytyped/typescript-versions and @definitelytyped/typescript-packages to support the next version, update tests, and publish a new release.
  • in other words, if we're releasing TypeScript 3.9, DefinitelyTyped needs to support 4.0.
  • An example PR

Release Activities

Release

• Tag release branch
• Draft and publish new release
• Close milestone corresponding to the release

Project Health

• Review perf dashboard to identify regressions
• Review crawler-discovered crashes (and ensure these have been running) (and ensure these have been running)
• Review NewErrors breaking change issues (and ensure these have been running)

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 @definitelytyped/typescript-versions: move the newly published version from supported to shipped (in the example above, that's 3.9), and publish a new release of @definitelytyped.

Website

• Update Handbook
• Add new release notes page

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)

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

User documentation

News

• Roadmap
• Breaking Changes
• API Breaking Changes

Debugging TypeScript

• Performance
• Performance-Tracing
• Debugging-Language-Service-in-VS-Code
• Getting-logs-from-TS-Server-in-VS-Code
• JavaScript-Language-Service-in-Visual-Studio
• Providing-Visual-Studio-Repro-Steps

Contributing to TypeScript

• Contributing to TypeScript
• TypeScript Design Goals
• Coding Guidelines
• Useful Links for TypeScript Issue Management
• Writing Good Design Proposals
• Compiler Repo Notes
• Deployment

Building Tools for TypeScript

• Architectural Overview
• Using the Compiler API
• Using the Language Service API
• Standalone Server (tsserver)
• TypeScript MSBuild In Depth
• Debugging Language Service in VS Code
• Writing a Language Service Plugin
• Docker Quickstart

FAQs

• FAQ
• FAQs for API Consumers

The Main Repo

• Triggering TypeScript Bot
• Tooling on the Compiler Repo

Want to contribute to this Wiki?

Fork it and send a pull request.