maxmustermann/dotnet-core
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Update support docs (#5819)

Browse source 
* 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>
This commit is contained in:
Rich Lander 2021-01-07 21:10:47 -08:00 committed by GitHub
parent 28613df3c1
commit e5f82ca7b5
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
17 changed files with 178 additions and 138 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

11
README.md
View file

@ -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

28
daily-builds.md
View file

@ -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
microsoft-support.md
View file

@ -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
os-lifecycle-policy.md
View file

@ -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)
@ -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
release-notes/1.0/README.md
View file

@ -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) |

10
release-notes/1.1/README.md
View file

@ -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 | - | - |

10
release-notes/2.0/README.md
View file

@ -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) | |

6
release-notes/2.1/README.md
View file

@ -1,6 +1,10 @@
# .NET Core 2.1 Releases
The following .NET Core 2.1 releases have been shipped. You must be on the latest patch release to be [supported by Microsoft](../../microsoft-support.md)
Important: .NET Core 2.1 is scheduled to go out of support on August 21, 2021. You should consider moving your usage to a later release.
[.NET Core 2.1](https://blogs.msdn.microsoft.com/dotnet/2018/05/30/announcing-net-core-2-1) was released on May 30th, 2018. The release was a collaborative effort by many [contributors](2.1.0-contributor.md). .NET Core 2.1 is [supported by Microsoft](../../microsoft-support.md) on [multiple operating systems](2.1-supported-os.md).
Release notes and download information is provided for each update, in the follow table. You must be on the latest update to be supported.
| Release Date | Description | Download |
| :-- | :-- | :--: |

10
release-notes/2.2/README.md
View file

@ -1,10 +1,14 @@
# .NET Core 2.2 Releases
# .NET Core 2.2 Release -- Out of support
The following .NET Core 2.2 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 2.2](https://blogs.msdn.microsoft.com/dotnet/2018/05/30/announcing-net-core-2-2) was released on December 4th, 2018. The release was a collaborative effort by many contributors. [.NET Core 2.2 reached end of life on December 23rd, 2019](https://devblogs.microsoft.com/dotnet/net-core-2-2-will-reach-end-of-life-on-december-23-2019/) It was [supported by Microsoft](../../microsoft-support.md) on [multiple operating systems](2.2-supported-os.md).
Release notes and download information is provided for each update, in the follow table.
| Release Date | Description | Download |
| :-- | :-- | :--: |
| 2019/12/23 | Out of support | [details](https://github.com/dotnet/core/blob/master/microsoft-support.md) |
| 2019/12/23 | Out of support | [.NET Core 2.2 end of life](https://devblogs.microsoft.com/dotnet/net-core-2-2-will-reach-end-of-life-on-december-23-2019/) |
| 2019/11/19 | [2.2.8](2.2.8/2.2.8.md) | [download](https://dotnet.microsoft.com/download/dotnet-core/2.2) |
| 2019/09/10 | [2.2.7](2.2.7/2.2.7.md) | [download](2.2.7/2.2.7-download.md) |
| 2019/07/09 | [2.2.6](2.2.6/2.2.6.md) | [download](2.2.6/2.2.6-download.md) |

10
release-notes/3.0/README.md
View file

@ -1,10 +1,14 @@
# .NET Core 3.0 Releases
# .NET Core 3.0 Release -- Out of support
The following .NET Core 3.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 3.0](https://blogs.msdn.microsoft.com/dotnet/2018/05/30/announcing-net-core-3-0) was released on September 23rd, 2019. The release was a collaborative effort by many contributors. [.NET Core 3.0 reached end of life on March 3, 2020](https://devblogs.microsoft.com/dotnet/net-core-3-0-end-of-life/) It was [supported by Microsoft](../../microsoft-support.md) on [multiple operating systems](3.0-supported-os.md).
Release notes and download information is provided for each update, in the follow table.
| Release Date | Description | Download |
| :-- | :-- | :--: |
| 2020/03/03 | Out of Support | see [details](https://github.com/dotnet/core/blob/master/microsoft-support.md#net-core-releases) |
| 2020/03/03 | Out of Support | [.NET Core 3.0 End of Life](https://devblogs.microsoft.com/dotnet/net-core-3-0-end-of-life/) |
| 2020/02/18 | [3.0.3](./3.0.3/3.0.3.md) | [download](https://dotnet.microsoft.com/download/dotnet-core/3.0) |
| 2020/01/14 | [3.0.2](./3.0.2/3.0.2.md) | [download](https://dotnet.microsoft.com/download/dotnet-core/3.0) |
| 2019/11/19 | [3.0.1](./3.0.1/3.0.1.md) | [download](https://dotnet.microsoft.com/download/dotnet-core/3.0) |

4
release-notes/3.1/README.md
View file

@ -1,6 +1,8 @@
# .NET Core 3.1 Releases
The following .NET Core 3.1 releases have been shipped. You must be on the latest patch release to be [supported by Microsoft](../../microsoft-support.md)
[.NET Core 3.1](https://devblogs.microsoft.com/dotnet/announcing-net-core-3-1/) was released on December 3rd, 2019. The release was a collaborative effort by many contributors. .NET Core 3.1 is [supported by Microsoft](../../microsoft-support.md) on [multiple operating systems](3.1-supported-os.md). [Known Issues](3.1-known-issues.md) are recorded and updated, as appropriate, with each update.
Release notes and download information is provided for each update, in the follow table. You must be on the latest update to be supported.
| Release Date | Description | Download |
| :-- | :-- | :--: |

12
release-notes/5.0/5.0-supported-os.md
View file

@ -1,23 +1,19 @@
# .NET 5 - Supported OS versions
Microsoft supports .NET 5 with multiple operating systems, according to official operating system lifecycle and distribution.
[Microsoft Support for .NET](https://github.com/dotnet/core/blob/master/microsoft-support.md) describes support for various .NET versions.
[Microsoft supports](https://github.com/dotnet/core/blob/master/microsoft-support.md) .NET 5 with multiple operating systems, in alignment with official operating system lifecycle and distribution.
## Windows
OS | Version | Architectures | Lifecycle
--------------------------------------|-------------------------|-----------------|----------
[Windows Client][Windows-client] | 7 SP1(**\***), 8.1 | x64, x86 | [Windows][Windows-lifecycle]
[Windows 10 Client][Windows-client] | Version 1607+(**\*\***) | x64, x86, Arm64 | [Windows][Windows-lifecycle]
[Windows 10 Client][Windows-client] | Version 1607+ | x64, x86, Arm64 | [Windows][Windows-lifecycle]
[Windows Server][Windows-Server] | 2012 R2+ | x64, x86 | [Windows Server][Windows-Server-lifecycle]
[Windows Server Core][Windows-Server] | 2012 R2+ | x64, x86 | [Windows Server][Windows-Server-lifecycle]
[Nano Server][Nano-Server] | Version 1809+ | x64 | [Windows Server][Windows-Server-lifecycle]
**\*** Windows 7 SP1 is supported with [Extended Security Updates](https://docs.microsoft.com/troubleshoot/windows-client/windows-7-eos-faq/windows-7-extended-security-updates-faq) installed.
**\*\*** Windows 10 1607 is the minimum version for support. See [Out of support OS versions](#out-of-support-os-versions) below for Windows 10 releases that are no longer supported.
[Windows-client]: https://www.microsoft.com/windows/
[Windows-lifecycle]: https://support.microsoft.com/help/13853/windows-lifecycle-fact-sheet
[win-client-docker]: https://hub.docker.com/_/microsoft-windows
@ -89,8 +85,6 @@ The following operating systems are no longer supported, starting with .NET 5.0.
Support for the following versions was ended by the distribution owners and are [no longer supported by .NET 5][OS-lifecycle-policy].
|OS | Version | End of Life | Supported Version|
|-----------|----------|-------------|------------------|
| Windows 10| 1703 | [10/08/2019](https://support.microsoft.com/help/13853/windows-lifecycle-fact-sheet) |
None yet.
[OS-lifecycle-policy]: https://github.com/dotnet/core/blob/master/os-lifecycle-policy.md

6
release-notes/5.0/README.md
View file

@ -1,6 +1,8 @@
# .NET 5 Releases
# .NET 5.0 Release
The following .NET 5 releases have been shipped. You must be on the latest patch release to be [supported by Microsoft](../../microsoft-support.md)
[.NET 5.0](https://devblogs.microsoft.com/dotnet/announcing-net-5-0/) was released on November 10th, 2020. The release was a collaborative effort by many [contributors](5.0-contributor-list.md). .NET 5.0 is [supported by Microsoft](../../microsoft-support.md) on [multiple operating systems](5.0-supported-os.md). [Known Issues](5.0-known-issues.md) are recorded and updated, as appropriate, with each update.
Release notes and download information is provided for each update, in the follow table. You must be on the latest update to be supported.
| Release Date | Description | Download |
| :-- | :-- | :--: |

29
release-notes/README.md
View file

@ -1,31 +1,18 @@
# .NET Core Release Notes
The latest supported release is [.NET Core 5.0](5.0).
## Latest Updates
You can download the latest updates for .NET Core.
* [.NET 5.0.1](5.0/5.0.1/5.0.1.md)
* [.NET Core 3.1.10](3.1/3.1.10/3.1.10.md)
* [.NET Core 2.1.23](2.1/2.1.23/2.1.23.md)
The following [.NET releases](../releases.md) are currently supported:
* [.NET 5.0](5.0/README.md)
* [.NET Core 3.1](3.1/README.md)
* [.NET Core 2.1](2.1/README.md)
You can find release notes for all releases, including out-of-support releases, in the [release-notes](.) directory.
## Release Information
* [.NET Core Releases](download-archive.md) -- Release notes and downloads
* [Download .NET](https://dotnet.microsoft.com/download/dotnet-core)
* [Releases Index][releases-index.json] -- Index for all release channels in JSON format
* [5.0 Release Details][5.0-releases.json] -- All releases details for the 5.0 channel in JSON format
* [3.1 Release Details][3.1-releases.json] -- All releases details for the 3.1 channel in JSON format
* [2.1 Release Details][2.1-releases.json] -- All releases details for the 2.1 channel in JSON format
## See also
* [.NET Core SDK telemetry](https://docs.microsoft.com/dotnet/core/tools/telemetry)
* [dotnet-install scripts](https://docs.microsoft.com/dotnet/core/tools/dotnet-install-script)
* [Installation docs](https://docs.microsoft.com/dotnet/core/install/)
[releases-index.json]: https://dotnetcli.blob.core.windows.net/dotnet/release-metadata/releases-index.json
[5.0-releases.json]: https://dotnetcli.blob.core.windows.net/dotnet/release-metadata/5.0/releases.json
[3.1-releases.json]: https://dotnetcli.blob.core.windows.net/dotnet/release-metadata/3.1/releases.json
[2.1-releases.json]: https://dotnetcli.blob.core.windows.net/dotnet/release-metadata/2.1/releases.json

57
release-policies.md Normal file
View file

@ -0,0 +1,57 @@
# 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.
## 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.
## Release types
Each .NET release is defined (prior to initial release) as either **Long Term Support (LTS)** or **Current**. The difference is support time frame, as defined below:
* **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.
* **Current** releases are supported for (typically) fifteen 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 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.
## Servicing periods
.NET Core releases are supported -- during the servicing period -- according to the following policies. Servicing policies are the same for LTS and Current releases.
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/master/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.
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).
### Full support
During the full support period, .NET releases are updated to improve functional capabilities and mitigate security vulnerabilities.
Functional improvements are typically very targeted, and may address the following:
* Resolve reported crashes.
* Resolve severe performance issues.
* Resolve functional bugs in mainline scenarios.
* Add support for a new operating system version or new hardware platform.
### Maintenance support
During the maintenance support period, .NET releases are updated to mitigate security vulnerabilities, only.
### End of support
"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.
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.
## Support Policies
The following policies are used to determine support length and kind.
* LTS releases are supported for three years. They receive full support for the first two years and are in maintenance for the third year. After that time, the release will be out-of-support.
* Current releases are typically supported for fifteen months. They receive full support for the first twelve months and are in maintenance for the last three months. After that time, the release will be out-of-support.
* A Current release will be supported for a shorter period if a new release (LTS or Current) is released within twelve months of that Current release. In that case, the Current release will immediately transition to three months of maintenance support. After that time, the release will be out-of-support.
## 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-core) and [Microsoft Update](https://devblogs.microsoft.com/dotnet/net-core-updates-coming-to-microsoft-update/).

22
releases.md Normal file
View file

@ -0,0 +1,22 @@
# .NET Releases
The .NET team releases new versions of .NET annually, each November. Releases are either Long Term Support (LTS) or Current, the two [.NET release types](release-policies.md).
The following table lists currently in-support .NET releases, per [Microsoft support policy](microsoft-support.md).
| Version | Release Date | Support Level | Supported Patch Version | End of Support |
| :-- | :-- | :-- | :-- | :-- |
| [.NET 5.0](https://dotnet.microsoft.com/download/dotnet-core/5.0) | [November 10, 2020](https://devblogs.microsoft.com/dotnet/announcing-net-5-0/) | Current | [5.0.1](release-notes/5.0/README.md) | February, 2022 |
| [.NET Core 3.1](https://dotnet.microsoft.com/download/dotnet-core/3.1) | [December 3, 2019](https://devblogs.microsoft.com/dotnet/announcing-net-core-3-1/) | LTS | [3.1.10](release-notes/3.1/README.md) | December 3, 2022 |
| [.NET Core 2.1](https://dotnet.microsoft.com/download/dotnet-core/2.1) | [May 30, 2018](https://devblogs.microsoft.com/dotnet/announcing-net-core-2-1/) | LTS | [2.1.23](release-notes/2.1/README.md) | August 21, 2021 |
The following table lists out-of-support releases.
| Version | Release Date | Support Level | Final Patch Version | End of Support |
| :-- | :-- | :-- | :-- | :-- |
| [.NET Core 3.0](https://dotnet.microsoft.com/download/dotnet-core/3.0) | [September 23, 2019](https://devblogs.microsoft.com/dotnet/announcing-net-core-3-0/) | Current | [3.0.3](release-notes/3.0/README.md) | [March 3, 2020](https://devblogs.microsoft.com/dotnet/net-core-3-0-end-of-life/) |
| [.NET Core 2.2](https://dotnet.microsoft.com/download/dotnet-core/2.2) | [December 4th, 2018](https://devblogs.microsoft.com/dotnet/announcing-net-core-2-2/) | Current | [2.2.8](release-notes/2.2/README.md) | [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://dotnet.microsoft.com/download/dotnet-core/2.0) | [August 14th, 2017](https://blogs.msdn.microsoft.com/dotnet/2017/08/14/announcing-net-core-2-0/) | Current | [2.0.9](release-notes/2.0/README.md) | [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://dotnet.microsoft.com/download/dotnet-core/1.1) | [November 16th, 2016](https://devblogs.microsoft.com/dotnet/announcing-net-core-1-1/) | LTS | [1.1.13](release-notes/1.1/README.md) | [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://dotnet.microsoft.com/download/dotnet-core/1.0) | [June 27th, 2016](https://devblogs.microsoft.com/dotnet/announcing-net-core-1-0/) | LTS | [1.1.16](release-notes/1.0/README.md) | [June 27, 2019](https://devblogs.microsoft.com/dotnet/net-core-1-0-and-1-1-will-reach-end-of-life-on-june-27-2019/) |

4
roadmap.md
View file

@ -33,9 +33,9 @@ Milestone information is available on most repos, for example [dotnet/runtime mi
The best way to give feedback is to create issues in the [dotnet/core](https://github.com/dotnet/core) repo. You can also create issues in other [.NET repos](Documentation/core-repos.md) if you find that to be more appropriate for the topic you want to discuss.
Although mostly obvious, please give us feedback that will give us insight on the following points:
Please give us feedback that will give us insight on the following points:
* Existing features are missing some capability or otherwise don't work well enough.
* Existing features that are missing some capability or otherwise don't work well enough.
* Missing features that should be added to the product.
* Design choices for a feature that is currently in-progress.