Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/dotnet/core.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRich Lander <rlander@microsoft.com>2022-10-27 20:22:10 +0300
committerGitHub <noreply@github.com>2022-10-27 20:22:10 +0300
commite349085c452b56642fd82bf0413d5b3280a1382c (patch)
tree349c202b9d3550a6c4833f7e24e75e81a1f5367f /release-policies.md
parent2381cf49c0037eff199b4ebff288cfc423511c34 (diff)
Switch to Standard Term Support (STS) releases (#7517)
* Switch to 'sts' for short term releases * Update release policies * Update supported OS links * Update supported OS links * Update release-policies.md * Apply suggestions from code review Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> * sts->standard * more updates * feedback * remove extra space * Apply suggestions from code review Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> * Update release-policies.md Co-authored-by: Jamshed Damkewala <jamshedd@users.noreply.github.com> * Update release-policies.md * Apply suggestions from code review * Update STS term Co-authored-by: Maira Wenzel <mairaw@microsoft.com> Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Co-authored-by: Jamshed Damkewala <jamshedd@users.noreply.github.com>
Diffstat (limited to 'release-policies.md')
-rw-r--r--release-policies.md52
1 files changed, 25 insertions, 27 deletions
diff --git a/release-policies.md b/release-policies.md
index 7e195dd2..b222aee2 100644
--- a/release-policies.md
+++ b/release-policies.md
@@ -1,52 +1,50 @@
# Release Policies
-The .NET team uses the following policies for [.NET releases](releases.md). They define what you can expect when you use a given .NET release.
+The .NET team uses the following policies for [.NET releases](releases.md).
## Release cadence
-New major .NET versions are released annually in November. .NET 5.0 was the first version to be released according to this schedule. Minor releases may also be released, with no pre-defined or regular schedule.
+New major .NET versions are released annually in November, at [.NET Conf](https://www.dotnetconf.net/).
-## Release types
+Patch updates are released monthly on the second Tuesday of each month, also known as Patch Tuesday.
-Each .NET release is defined (prior to initial release) as either **Preview**, **Current**, or **Long Term Support (LTS)**. The difference is support time frame, as defined below:
+Minor versions of the .NET SDK are released approximately quarterly. These are known as [feature bands](https://learn.microsoft.com/dotnet/core/releases-and-support#feature-bands-sdk-only).
-* **Preview** releases are not supported but are offered for public testing. A Preview or Release Candidate release may be declared as "go live" by Microsoft and be supported in production.
-* **Current** releases are supported for (typically) eighteen months. They are intended for users that want to take advantage of the newest features and improvements and to stay on the leading edge of .NET innovation. Current release users need to upgrade to later .NET releases more often to stay in support.
-* **LTS** releases are supported for three years. They are intended for users that want the stability and lower cost of maintaining an application on a single (major.minor) .NET version for an extended period.
+## Release types
-LTS and Current releases have many similarities. The .NET team follows the same software engineering and release processes for both release types, including for security, compatibility, and reliability. Both releases may contain major new features and breaking changes. The .NET team aspires to enable straightforward migration from one release to another (LTS or Current, in either direction), and has processes in place to achieve that intention.
+Each .NET release is defined as either **Standard Term Support (STS)** or **Long Term Support (LTS)**, at the beginning of the release.
-## Servicing
+* **STS** releases are supported for eighteen months, released in even-numbered years. They are intended for users that want to take advantage of the newest features and improvements and to stay on the leading edge of .NET innovation.
+* **LTS** releases are supported for three years, released in odd-numbered years. They are intended for users that want the stability and lower cost of maintaining an application for an extended period, only needing to upgrade their .NET version for security patches.
-.NET releases are supported -- during the servicing period -- according to the following policies. Servicing policies are the same for LTS and Current releases.
+Note: **Standard Term Support** releases were previously called **Current**.
-A single "bug bar" is used to decide if a change is warranted and safe for servicing updates. A given fix is often applied to multiple [servicing branches](https://github.com/dotnet/core/blob/main/daily-builds.md#servicing-releases), independent of release type. Breaking changes are not accepted during servicing, except (in the very rare case) to resolve a security vulnerability.
+LTS and STS releases differ only by support duration. The .NET team follows the same software engineering and release processes for both release types, including for security, compatibility, and reliability. Both releases may contain major new features and breaking changes. The .NET team aspires to enable straightforward migration from one release to another, for both release types.
-Improvements are released as "patches". Patch releases are cumulative. Patches are released on the Microsoft "Patch Tuesday" (second Tuesday of each month), however there is no guarantee that there will be a .NET release on any given Patch Tuesday. Patches are announced on the [.NET blog](https://devblogs.microsoft.com/dotnet/). A digest of monthly releases is published to [dotnet/announcements](https://github.com/dotnet/announcements/labels/Monthly-Update).
+## Support phases
-### Full support
+.NET releases go through multiple support phases, with varying support levels.
-During the full support period, .NET releases are updated to improve functional capabilities and mitigate security vulnerabilities.
+* **Preview** releases are not supported but are offered for the community to test and give feedback.
+* **Go-Live** releases are supported by Microsoft in production. These are typically our release candidate builds, just before the Generally Available (GA) release.
+* **Active** support is provided for the majority of the period after a release is GA. Functional and security improvements will be provided, including support for new operating system versions.
+* **Maintenance** support is provided for the last six months of support. Improvements are limited to security fixes. Support for new operating system versions will be provided on a best-effort basis.
+* **End of life (EOL)** marks the end of support.
-Functional improvements are typically very targeted, and may address the following:
+[Support for various operating systems](os-lifecycle-policy.md) is defined for each release.
-* Resolve reported crashes.
-* Resolve severe performance issues.
-* Resolve functional bugs in mainline scenarios.
-* Add support for a new [operating system version](os-lifecycle-policy.md) or new hardware platform.
-
-### Maintenance support
+## Servicing
-During the maintenance support period, .NET releases are updated to mitigate security vulnerabilities, only.
+Improvements are released as full re-releases of the product, called "patch releases". Patch releases are cumulative. Patches are released on the Microsoft "Patch Tuesday" (second Tuesday of each month), however there is no guarantee that there will be a .NET release on any given Patch Tuesday.
-The maintenance support period is the final 6 months of support for any release (Current or LTS). After the maintenance period ends, the release is out of support.
+Patches are announced in [release notes](release-notes/README.md), on the [.NET blog](https://devblogs.microsoft.com/dotnet/category/maintenance-and-updates/), and [dotnet/announcements](https://github.com/dotnet/announcements/labels/Monthly-Update).
-### End of support
+Breaking changes are not accepted during servicing, except in the rare case to mitigate a security vulnerability or other critical issue.
-"End of support", "out of support", or "end of life" refers to the date after which fixes, updates, or technical assistance are no longer provided. As the end of support nears for a given .NET version, we recommend that you move to a newer .NET version, and reduce/remove your use of the given .NET version. After support ends, we recommend that you uninstall a given .NET version if you are no longer using it, or install the latest patch, and accelerate your plans to remove your use of that .NET version.
+## End of support
-Your use of out-of-support .NET versions may put your applications, application data, and computing environment at risk. You are strongly recommended to not use out-of-support software.
+As the end of support nears for a given .NET version, we strongly recommend you move to a newer, supported version of .NET. .NET releases that have reached end of support do not get security patches. Continuing to use an unsupported version will expose you to security vulnerabilities.
## Vendor support
-[Microsoft offers support](microsoft-support.md) for in-support releases. Updates are provided at [dotnet.microsoft.com](https://dotnet.microsoft.com/download/dotnet) and [Microsoft Update](https://devblogs.microsoft.com/dotnet/net-core-updates-coming-to-microsoft-update/).
+[Microsoft offers support](microsoft-support.md) for .NET releases, per these policies. Updates are provided at the [.NET Website](https://dotnet.microsoft.com/download/dotnet), [Microsoft Update](https://devblogs.microsoft.com/dotnet/net-core-updates-coming-to-microsoft-update/), [Linux Package Managers](https://docs.microsoft.com/dotnet/core/install/linux), and the [Microsoft Artifact Registry](https://mcr.microsoft.com/catalog?search=dotnet/).