Skip to content

Commit

Permalink
Update support docs (#5819)
Browse files Browse the repository at this point in the history
* Update support docs

* Update links

* Update servicing builds

* Update table

* Update out-of-support table

* Update os support page

* Update daily builds

* Update intro to each version

* Update per feedback

* Update release policies

* rename release-types file

* Update per feedback

* Move release-policies.md to root

* Update release-policies.md

* Add vendor support section

* Add Microsoft support link

* Update microsoft-support.md

Co-authored-by: Maira Wenzel <mairaw@microsoft.com>

* Update per feedback

Co-authored-by: Maira Wenzel <mairaw@microsoft.com>
  • Loading branch information
richlander and mairaw committed Jan 8, 2021
1 parent 28613df commit e5f82ca
Show file tree
Hide file tree
Showing 17 changed files with 178 additions and 138 deletions.
11 changes: 4 additions & 7 deletions README.md
Expand Up @@ -2,15 +2,12 @@

The dotnet/core repository is a good starting point for .NET Core.

The latest major release is [.NET 5.0](release-notes/5.0). The latest patch updates are listed in [.NET Core release notes](release-notes/README.md).
The latest major release is [.NET 5.0](release-notes/5.0/README.md). The latest patch updates are listed in [.NET Core release notes](release-notes/README.md).

## Download the latest .NET Core SDK
## .NET Core Releases

* [.NET 5.0 SDK](release-notes/5.0/README.md)

## .NET Core Releases and Daily Builds

* [.NET Core released builds](release-notes/README.md)
* [Download the latest .NET Core SDK](https://dotnet.microsoft.com/download/dotnet/5.0)
* [.NET Core releases](releases.md)
* [.NET Core daily builds](daily-builds.md)

## Learn about .NET Core
Expand Down
28 changes: 15 additions & 13 deletions daily-builds.md
@@ -1,23 +1,25 @@
# .NET Core Daily Builds -- Servicing and future releases
# .NET Daily Builds -- Servicing and future releases

The .NET Core team builds many branches of the product daily. You can install these builds to try out functionality prior to release.
The .NET team builds many branches of the product daily. You can install these builds to try out functionality prior to release.

Daily builds, for both future and servicing branches, are available as Docker container images from the [Microsoft Container Registry](https://hub.docker.com/_/microsoft-dotnet-nightly/).

## Future Releases

Preview branches are for new major/minor versions of .NET Core that have not yet been released and are not yet supported.
Preview branches are for new versions of .NET that have not yet been released and are not yet supported.

|Component|*.NET 5.0*
|Component|*.NET 6.0*
|:------:|:------:|
|SDK|[.NET Core SDK 5.0.xxx (Master)](https://github.com/dotnet/core-sdk/blob/master/README.md#installers-and-binaries)
|ASP.NET Core|[ASP.NET Core Shared Framework 5.0 (Master)](https://github.com/aspnet/AspNetCore/blob/master/docs/DailyBuilds.md)
|Runtime|[.NET Core Runtime 5.0 (Master)](https://github.com/dotnet/core-setup/blob/master/README.md#daily-builds)
|SDK|[.NET SDK 6.0.xxx](https://github.com/dotnet/installer/blob/master/README.md#installers-and-binaries)
|ASP.NET Core|[ASP.NET Core 6.0](https://github.com/aspnet/AspNetCore/blob/master/docs/DailyBuilds.md)
|Runtime|[.NET Runtime 6.0](https://github.com/dotnet/installer/blob/master/README.md#daily-builds)

## Servicing Releases

Servicing branches are for new patch versions of .NET Core that have not yet been released and are not yet supported. These patch versions are for previously released major/minor versions.
Servicing branches are for new patch versions of .NET that have not yet been released and are not yet supported.

|Component|*.NET Core 3.1*|*.NET Core 2.1*
|:------:|:------:|:------:|
|SDK|[.NET Core SDK 3.1](https://github.com/dotnet/core-sdk/blob/master/README.md#installers-and-binaries)|[.NET Core SDK 2.1.xxx](https://github.com/dotnet/cli/blob/release/2.1/README.md#installers-and-binaries)|
|ASP.NET Core|[ASP.NET Core Shared Framework 3.1](https://github.com/aspnet/AspNetCore/blob/master/docs/DailyBuilds.md)|[ASP.NET Core Shared Framework 2.1](https://github.com/aspnet/AspNetCore/blob/master/docs/DailyBuilds.md)|
|Runtime|[.NET Core Runtime 3.1](https://github.com/dotnet/core-setup/blob/master/README.md#daily-builds)|[.NET Core Runtime 2.1](https://github.com/dotnet/core-setup/blob/master/README.md#daily-builds)|
|Component|*.NET 5.0*|*.NET Core 3.1*|*.NET Core 2.1*|
|:------:|:------:|:------:|:------:|
|SDK|[.NET SDK 5.0.xxx](https://github.com/dotnet/installer/blob/master/README.md#installers-and-binaries)|[.NET Core SDK 3.1.xxx](https://github.com/dotnet/core-sdk/blob/master/README.md#installers-and-binaries)|[.NET Core SDK 2.1.xxx](https://github.com/dotnet/cli/blob/release/2.1/README.md#installers-and-binaries)|
|ASP.NET Core|[ASP.NET Core 5.0](https://github.com/aspnet/AspNetCore/blob/master/docs/DailyBuilds.md)|[ASP.NET Core 3.1](https://github.com/aspnet/AspNetCore/blob/master/docs/DailyBuilds.md)|[ASP.NET Core 2.1](https://github.com/aspnet/AspNetCore/blob/master/docs/DailyBuilds.md)|
|Runtime|[.NET Core Runtime 5.0](https://github.com/dotnet/installer/blob/master/README.md#daily-builds)|[.NET Core Runtime 3.1](https://github.com/dotnet/core-setup/blob/master/README.md#daily-builds)|[.NET Core Runtime 2.1](https://github.com/dotnet/core-setup/blob/master/README.md#daily-builds)|
65 changes: 12 additions & 53 deletions microsoft-support.md
@@ -1,61 +1,20 @@
# Microsoft .NET Core support lifecycle
# Microsoft support for .NET

Every Microsoft product has a lifecycle, including .NET Core. The lifecycle begins when a product is released and ends when it's no longer supported. Knowing key dates in this lifecycle helps you make informed decisions about when to upgrade or make other changes to your software. This product is governed by the [Microsoft Modern Lifecycle](https://support.microsoft.com/help/30881/modern-lifecycle-policy).
Microsoft supports .NET on multiple operating systems, per the [Microsoft Modern Lifecycle](https://support.microsoft.com/help/30881/modern-lifecycle-policy).

This document describes the support lifecycle for: .NET Core, ASP.NET Core and EF Core.
Support is provided for: .NET SDK, .NET runtime, ASP.NET Core, and EF Core.

The [.NET Core OS Lifecycle Policy](https://github.com/dotnet/core/blob/master/os-lifecycle-policy.md) describes support for various operating systems.
Support has two key benefits:

## .NET Core Releases
* Patches are provided (for free) as required for functional or security issues, typically monthly.
* You can [contact Microsoft support to request help](https://support.serviceshub.microsoft.com/supportforbusiness/onboarding) (potentially at a cost).

This table describes support type, supported patch version and end of support date for .NET Core releases.
You can also request community support on GitHub (for free), but there is no guarantee on a quick reply.

| Version | Release Date | Support Level | Supported Patch Version | End of Support |
| :-- | :-- | :-- | :-- | :-- |
| [.NET 5.0](https://devblogs.microsoft.com/dotnet/announcing-net-5-0/) | November 10, 2020 | Current | [5.0.1](https://dotnet.microsoft.com/download/dotnet-core/5.0) | 3 Months after .NET 6 is released |
| [.NET Core 3.1](https://devblogs.microsoft.com/dotnet/announcing-net-core-3-1/) | December 3, 2019 | LTS | [3.1.10](https://dotnet.microsoft.com/download/dotnet-core/3.1) | December 3, 2022 |
| [.NET Core 2.1](https://blogs.msdn.microsoft.com/dotnet/2018/05/30/announcing-net-core-2-1) | May 30, 2018 | LTS | [2.1.23](https://dotnet.microsoft.com/download/dotnet-core/2.1) | August 21, 2021 |
Support is conditional on using the latest .NET patch update and a supported operating system, as defined by:

For previous versions, [see here](https://dotnet.microsoft.com/platform/support/policy/dotnet-core).
* [.NET release policies](release-policies.md)
* [.NET release lifecycle](releases.md)
* [Operating system lifecycle](os-lifecycle-policy.md).

## Release Types

Microsoft produces **Long Term Support (LTS)** and **Current** releases, which are defined as:

* **LTS** releases are designed for long-term support. They included features and components that have been stabilized, requiring few updates over a longer support release lifetime. These releases are a good choice for hosting applications that you do not intend to update.
* **Current** releases include new features that may undergo future change based on feedback. These releases are a good choice for applications in active development, giving you access to the latest features and improvements. You need to upgrade to later .NET Core releases more often to stay in support.

Both types of releases receive critical fixes throughout their lifecycle, for security, reliability, or to add support for new operating system versions. You must stay up-to-date with the latest patches to qualify for support.

## Release Support Policies

.NET Core releases are supported according to the following policies.

### Long Term Support (LTS) releases

LTS releases are supported for three years after the initial release.


### Current releases

Current releases are supported for three months after a subsequent Current or LTS release.

### Maintenance releases

Maintenance releases are in the last stage of the lifecycle . During Maintenance, a release will receive security updates. The length of Maintenance time is 3 months for Current and 1 year for LTS.

### End of support

End of support refers to the date when Microsoft no longer provides fixes, updates, or online technical assistance. As this date nears, make sure you have the latest available update\* installed. Without Microsoft support, you will no longer receive security updates that can help protect your machine from harmful viruses, spyware, and other malicious software that can steal your personal information.

\* Updates are cumulative, with each update built upon all of the updates that preceded it. A device needs to install the latest update to remain supported. Updates may include new features, fixes (security and/or non-security), or a combination of both. Not all features in an update will work on all devices. Update availability may vary, for example by country, region, network connectivity, or hardware capabilities (including, for example, free disk space).

### Out of support .NET Core releases

| Version | End of Support |
| :-- | :-- |
| [.NET Core 3.0](https://devblogs.microsoft.com/dotnet/announcing-net-core-3-0/) | [March 3, 2020](https://devblogs.microsoft.com/dotnet/net-core-3-0-end-of-life/) |
| [.NET Core 2.2](https://devblogs.microsoft.com/dotnet/announcing-net-core-2-2/) | [December 23, 2019](https://devblogs.microsoft.com/dotnet/net-core-2-2-will-reach-end-of-life-on-december-23-2019/)
| [.NET Core 2.0](https://blogs.msdn.microsoft.com/dotnet/2017/08/14/announcing-net-core-2-0/) | [October 1, 2018](https://devblogs.microsoft.com/dotnet/net-core-2-0-will-reach-end-of-life-on-september-1-2018/)
| [.NET Core 1.1](https://blogs.msdn.microsoft.com/dotnet/2016/11/16/announcing-net-core-1-1/) | [June 27, 2019](https://devblogs.microsoft.com/dotnet/net-core-1-0-and-1-1-will-reach-end-of-life-on-june-27-2019/)
| [.NET Core 1.0](https://blogs.msdn.microsoft.com/dotnet/2016/06/27/announcing-net-core-1-0/) | [June 27, 2019](https://devblogs.microsoft.com/dotnet/net-core-1-0-and-1-1-will-reach-end-of-life-on-june-27-2019/)
Knowing key dates for a product lifecycle helps you make informed decisions about when to upgrade or make other changes to your software and computing environment.
22 changes: 8 additions & 14 deletions os-lifecycle-policy.md
@@ -1,20 +1,18 @@
# .NET Core Supported OS Lifecycle Policy
# .NET Supported OS Policy

.NET Core is [supported by Microsoft](microsoft-support.md) on a range of operating systems.
.NET is [supported by Microsoft](microsoft-support.md) on multiple operating systems, defined per .NET version.

Each supported operating system has a lifecycle defined by its sponsor organization (for example, Microsoft, Red Hat, or Apple). The .NET Core team applies each of those lifecycle schedules to inform adding and removing support for operating system versions.
Each supported operating system has a lifecycle defined by its sponsor organization (for example, Microsoft, Red Hat, Debian, or Apple). The .NET team applies each of those lifecycle schedules to inform adding and removing support for operating system versions.

The following support documents list currently supported operating system versions for supported .NET Core versions:
When an operating system version goes out of support, we stop testing that version and providing support for that version. This means that users will need to move forward to a supported operating system version to get support.

The following documents define currently supported operating system versions for supported .NET Core versions:

* [.NET 5 supported OS versions](release-notes/5.0/5.0-supported-os.md)
* [.NET Core 3.1 supported OS versions](release-notes/3.1/3.1-supported-os.md)
* [.NET Core 2.1 supported OS versions](release-notes/2.1/2.1-supported-os.md)

## Out-of-Support .NET Core versions

When an operating system version goes out of support, we stop testing that version and providing support for that version. This means that users will need to move forward to a supported operating system version to get support. Previously released packages will remain available for users needing access.

The following support documents list historical operating system support for out-of-support .NET Core versions:
The following documents define (historical) operating system support for out-of-support .NET Core versions:

* [.NET Core 3.0 supported OS versions](release-notes/3.0/3.0-supported-os.md)
* [.NET Core 2.2 supported OS versions](release-notes/2.2/2.2-supported-os.md)
Expand All @@ -28,12 +26,8 @@ Operating system versions are added and go out of support on a regular basis. We
* The support documents listed above
* [Monthly Update Announcements](https://github.com/dotnet/announcements/labels/Monthly-Update)

When a new operating system version is made available, we will typically support it on a subset of supported .NET Core versions, potentially only with the latest .NET Core version.

## Exceptions to the supported platform policy

Occasionally, we may not adhere to a strict interpretation of the policy for supported OS platforms. Instead, we may choose to offer support on an OS platform that is out of support. Or we may choose to exclude a supported platform for specific reasons.
Occasionally, we may choose to offer support on an OS platform that is out of support. Or we may choose to exclude a supported platform for specific reasons.

One example is Windows 7 SP1. Windows 7 SP1 is out of support, but enterprise customers can buy [Extended Security Updates](https://docs.microsoft.com/troubleshoot/windows-client/windows-7-eos-faq/windows-7-extended-security-updates-faq), and many do. Given the widespread use of Windows 7 in the .NET ecosystem we chose to include Windows 7 SP1 (with Extended Security Updates installed) as a supported platform for .NET 5.0. Another example is Windows Server 2012. Windows Server 2012 is currently in support but not included in the supported platform list for .NET 5.0 because a newer version is available in the Server 2012 family - Server 2012 R2.

**_When there is a conflict between our general policy for supported platforms and the specific supported platforms documented for a given release of .NET the supported platform list for the specific version of .NET will supersede the general policy._**
10 changes: 7 additions & 3 deletions release-notes/1.0/README.md
@@ -1,10 +1,14 @@
# .NET Core 1.0 Releases
# .NET Core 1.0 Release -- Out of support

The following .NET Core 1.0 releases have been shipped. You must be on the latest patch release to be [supported by Microsoft](../../microsoft-support.md)
This release is out of support. See [.NET releases](../../releases.md) for in-support releases.

[.NET Core 1.0](https://devblogs.microsoft.com/dotnet/announcing-net-core-1-0/) was released on June 27th, 2016. The release was a collaborative effort by many [contributors](1.0.0-contributor-list.md). [.NET Core 1.0 reached end of life on June 27th, 2019](https://devblogs.microsoft.com/dotnet/net-core-1-0-and-1-1-will-reach-end-of-life-on-june-27-2019/). It was [supported by Microsoft](../../microsoft-support.md) on [multiple operating systems](1.0-supported-os.md).

Release notes and download information is provided for each update, in the follow table.

| Release Date | Description | |
| :-- | :-- | :--: |
| 2019/06/27 | Out of support | [details](https://github.com/dotnet/core/blob/master/microsoft-support.md#out-of-support-net-core-releases) |
| 2019/06/27 | Out of support | [.NET Core 1.0 end of life](https://devblogs.microsoft.com/dotnet/net-core-1-0-and-1-1-will-reach-end-of-life-on-june-27-2019/) |
| 2019/05/14 | 1.0.16 with SDK 1.1.14 | [release notes](1.0.16/1.0.16.md)/[download](1.0.16/1.0.16-download.md) |
| 2019/03/12 | 1.0.15 with SDK 1.1.13 | [release notes](1.0.15/1.0.15.md)/[download](1.0.15/1.0.15-download.md) |
| 2019/02/12 | 1.0.14 with SDK 1.1.12 | [release notes](1.0.14/1.0.14.md)/[download](1.0.14/1.0.14-download.md) |
Expand Down
10 changes: 7 additions & 3 deletions release-notes/1.1/README.md
@@ -1,10 +1,14 @@
# .NET Core 1.1 Releases
# .NET Core 1.1 Releases -- Out of support

The following .NET Core 1.1 releases have been shipped. You must be on the latest patch release to be [supported by Microsoft](../../microsoft-support.md)
This release is out of support. See [.NET releases](../../releases.md) for in-support releases.

[.NET Core 1.1](https://devblogs.microsoft.com/dotnet/announcing-net-core-1-1/) was released on November 16th, 2016. The release was a collaborative effort by many [contributors](1.1-contributor-list.md). [.NET Core 1.1 reached end of life on June 27th, 2019](https://devblogs.microsoft.com/dotnet/net-core-1-0-and-1-1-will-reach-end-of-life-on-june-27-2019/). It was [supported by Microsoft](../../microsoft-support.md) on [multiple operating systems](1.1-supported-os.md).

Release notes and download information is provided for each update, in the follow table.

| Release Date | Description | Commits | Known Issues | Contributors |
| :-- | :-- | :--: | :--: | :--: |
| 2019/06/27 | Out of support - see [details](https://github.com/dotnet/core/blob/master/microsoft-support.md#out-of-support-net-core-releases) | - | - | - |
| 2019/06/27 | [.NET Core 1.1 end of life](https://devblogs.microsoft.com/dotnet/net-core-1-0-and-1-1-will-reach-end-of-life-on-june-27-2019/) | - | - | - |
| 2019/05/14 | 1.1.13 with SDK 1.1.14 ([release notes](1.1.13/1.1.13.md) / [download](1.1.13/1.1.13-download.md)) | see release notes | - | - |
| 2019/03/12 | 1.1.12 with SDK 1.1.13 ([release notes](1.1.12/1.1.12.md) / [download](1.1.12/1.1.12-download.md)) | see release notes | - | - |
| 2019/02/12 | 1.1.11 with SDK 1.1.12 ([release notes](1.1.11/1.1.11.md) / [download](1.1.11/1.1.11-download.md)) | see release notes | - | - |
Expand Down
10 changes: 7 additions & 3 deletions release-notes/2.0/README.md
@@ -1,10 +1,14 @@
# .NET Core 2.0 Releases - Out of support
# .NET Core 2.0 Release -- Out of support

The following .NET Core 2.0 releases have been shipped.
This release is out of support. See [.NET releases](../../releases.md) for in-support releases.

[.NET Core 2.0](https://devblogs.microsoft.com/dotnet/announcing-net-core-2-0/) was released on December 4th, 2018. The release was a collaborative effort by many [contributors](2.0.0-contributor.md). [.NET Core 2.0 reached end of life on October 1st, 2018](https://devblogs.microsoft.com/dotnet/net-core-2-0-will-reach-end-of-life-on-september-1-2018/). It was [supported by Microsoft](../../microsoft-support.md) on [multiple operating systems](2.0-supported-os.md).

Release notes and download information is provided for each update, in the follow table.

| Release Date | Description | | |
| :-- | :-- | :--: | :-- |
| 2018/10/01 | Out of support | [details](https://github.com/dotnet/core/blob/master/microsoft-support.md#out-of-support-net-core-releases) | |
| 2018/10/01 | Out of support | [.NET Core 2.0 end of life](https://devblogs.microsoft.com/dotnet/net-core-2-0-will-reach-end-of-life-on-september-1-2018/) | |
| 2018/07/10 | 2.0.9 with SDK 2.1.202 | [release notes](2.0.9.md)/[download](../download-archives/2.0.9-download.md) | |
| 2018/05/08 | 2.0.7 with SDK 2.1.200 | [release notes](https://github.com/dotnet/cli/releases/tag/v2.1.200)/[download](../download-archives/2.1.200-sdk-download.md) |
| 2018/04/17 | 2.0.7 with SDK 2.1.105 | [release notes](2.0.7.md)/[download](../download-archives/2.0.7-download.md) | |
Expand Down

0 comments on commit e5f82ca

Please sign in to comment.