Skip to content

Latest commit

 

History

History
66 lines (38 loc) · 5.14 KB

SUPPORT.md

File metadata and controls

66 lines (38 loc) · 5.14 KB

Support

Teams Toolkit lifecycle and support policy

The Teams Toolkit lifecycle and support policy covers GA and future versions.

Teams Toolkit products will follow Modern Lifecycle Policy unless otherwise noted.

In addition, we want to add additional support on top of Microsoft standard Modern Lifecycle Policy:

Teams Toolkit for Visual Studio Code

Visual Studio Code is also following Modern Lifecycle Policy.

As extension on Visual Studio Code, we would follow Modern Lifecycle Policy add additional support that for any Teams Toolkit for Visual Studio Code major version, we offer 2-year support* since its first release.

Teams Toolkit for Visual Studio

Visual Studio follows the Fixed Lifecycle Policy with a 10-year support of major versions (5 years Mainstream and 5 years Extended), and a Channel-based support for 18 months of minor versions. Since our product is extension to Visual Studio Product, we are not on Visual Studio’s own support policy. but we will offer 2-year support* for major versions, and 18 months for the minor versions. Teams Toolkit for Visual Studio is in sync with the same version of Visual Studio.

Teams Toolkit CLI & SDK

Currently Teams Toolkit CLI/SDK is published as NPM package. From npm package store customer can install any specified version.

We have a plan to merge back into future consolidated M365 app SDK and will be part of it. Support plan will follow the new SDK.

For now, we model after Azure SDK’s lifecycle and support policy:

Package lifecycle

Here are the stages of a typical package lifecycle (for major versions)

  1. Beta – A new SDK/CLI that is available for early access and feedback purposes and is not recommended for use in production. The beta version support is limited to GitHub issues and response time is not guaranteed. Beta releases live typically for less than 1 year, after which they are either deprecated or released as stable.
  2. Active - The SDK/CLIs are generally available and fully supported, will receive new feature updates, as well as bug and security fixes. The major version will remain active for at least 12 months from the release date. Compatible updates for the major release are provided through minor versions, or patch versions. Customers are encouraged to use the latest version as that is the version that will get fixes and updates.
  3. Deprecated - A library has been superseded by a more recent release. In this case, the current library is deprecated in favor of a newer library. Typically, deprecation occurs at the same time the replacement library is transitioned to Active, after which the releases will only address the most critical bug fixes and security fixes for at least another 12 months.
  4. Community – SDK/CLI will no longer receive updates from Microsoft unless otherwise specified in the separate customer agreement. The package will remain available via public package managers and the GitHub repo, which can be maintained by the community.

CLI/SDK dependencies

Teams Toolkit CLI and SDK depend on Microsoft Teams Platform, Teams Dev Portal, SharePoint Framework, Microsoft Azure, programming language runtime, OS, and third-party libraries.

Teams Toolkit CLI/SDK will not be guaranteed to work on platforms and other dependencies that have reached their end of life. Dropping support for such dependencies may be done without increasing the major version of CLI/SDK. We strongly recommend migration to supported platforms and other dependencies to be eligible for technical support.

support means we apply critical patches, fix critical bugs, but do not add new features.

Version mapping

Teams Toolkit for Visual Studio Code Teams Toolkit for Visual Studio Teams Toolkit CLI TeamsFx SDK Teams SDK Manifest
Public Preview v3.8.x v17.2 v0.14.x v0.7.x v1.11.x, v1.12.x v1.11
GA v4.0.0 v17.3 v1.0.0 v1.0.0 v1.12.x v1.11
Latest* v5.x.x v17.6 v2.x.x v2.x.x v2.x.x v1.16
Beta** Prerelease v17.7 Preview v2.x.x-beta v2.x.x-beta v2.x.x-beta devPreview
  • *Latest is aligned on the major version.
  • **Means this is on developer preview.

How to file issues and get help

This project uses GitHub Issues and StackOverflow questions to track bugs and feature requests. Please search the existing github issues and/or teams-toolkit tag on StackOverflow before filing any new issues to avoid duplicates.

For new issues, file your bug or feature request as a new github Issue or post questions on StackOverflow using tag teams-toolkit.

Microsoft Support Policy

Support for this repository is limited to the resources listed above.