jprdonnelly/core
1
0
Fork 0
mirror of synced 2025-12-19 18:06:02 -05:00
Code Issues Projects Releases Wiki Activity

Update README and related files (#9478)

Browse Source 
* Update README and related files

* Change schema name

* Cleanup mistakes

* Comment out future content

* Reduce line length
This commit is contained in:
Rich Lander
2024-08-22 15:54:43 -07:00
committed by GitHub
parent a0703e1402
commit 1f44a9a4f2
10 changed files with 1760 additions and 270 deletions
Download Patch File Download Diff File Expand all files Collapse all files

78
release-notes/README.md
View File

@@ -1,6 +1,6 @@
# .NET Release Notes
The following table lists [releases](../releases.md) under active development or support:
[Releases](../releases.md) under active support or development:
| Version | Release Date | Support | Latest Patch Version | End of Support |
| :-- | :-- | :-- | :-- | :-- |
@@ -8,20 +8,70 @@ The following table lists [releases](../releases.md) under active development or
| [.NET 8](8.0/README.md) | [November 14, 2023](https://devblogs.microsoft.com/dotnet/announcing-dotnet-8/) | [LTS][policies] | [8.0.8][8.0.8] | November 10, 2026 |
| [.NET 6](6.0/README.md) | [November 8, 2021](https://devblogs.microsoft.com/dotnet/announcing-net-6/) | [LTS][policies] | [6.0.33][6.0.33] | November 12, 2024 |
You can find release notes for all releases, including out-of-support releases, in the [release-notes](.) directory.
[9.0.0-preview.7]: 9.0/preview/preview7/9.0.0-preview.7.md
[8.0.8]: 8.0/8.0.8/8.0.8.md
[6.0.33]: 6.0/6.0.33/6.0.33.md
* [Release note formats](./formats.md)
* [Releases index][releases-index.json]
## Download .NET
* [Download .NET](https://dotnet.microsoft.com/download/dotnet)
* [Installation docs](https://learn.microsoft.com/dotnet/core/install/)
* [dotnet-install scripts](https://learn.microsoft.com/dotnet/core/tools/dotnet-install-script)
[releases-index.json]: https://dotnetcli.blob.core.windows.net/dotnet/release-metadata/releases-index.json
[policies]: ../release-policies.md
* [Binaries and installers](https://dotnet.microsoft.com/download/dotnet)
* [Installation docs](https://learn.microsoft.com/dotnet/core/install/)
You can find release notes for all releases in the [release-notes](.) directory, in markdown and [JSON formats](./schemas/README.md). This content is [licensed](./license-information.md) for broad use.
## Monthly patch release notes
Patch releases are published monthly, often including fixes for vulnerabilities (AKA CVEs) that are disclosed at the same time.
Release notes include:
- Links to binaries
- Notable changes, including CVEs
- Compatibility information
- Updated packages
Example markdown files:
- [6.0/6.0.32/6.0.32.md](./6.0/6.0.32/6.0.32.md)
- [8.0/8.0.1/8.0.1.md](./8.0/8.0.1/8.0.1.md)
Example JSON files:
- [Major releases index](./releases-index.json)
- [Major release](./9.0/releases.json)
`releases-index.json` and all the files it references are stored in blob storage and in GitHub. We use GitHub for easy discoverability of the files and Azure Blob Storage as our production platform.
It is straightforward to programmatically transform the [blob storage links](https://dotnetcli.blob.core.windows.net/dotnet/release-metadata/releases-index.json) to [`raw` GitHub links](https://raw.githubusercontent.com/dotnet/core/main/release-notes/releases-index.json) should that be desired.
Note: monthly previews are published in the same way, often on the same day. They are not supported so do not include CVE information. However, Release Candidate releases follow our ["Go Live" policy](https://github.com/dotnet/core/blob/main/release-policies.md) and may include CVE information.
## Monthly preview release notes
We typically release a preview for the next major version each month. These include detailed feature information.
Examples:
- [.NET 9 Preview 1](./9.0/preview/preview1/README.md)
- [.NET 9 Preview 6](./9.0/preview/preview6/README.md)
This content is used as source material for [What's New](https://learn.microsoft.com/dotnet/core/whats-new/) pages in official Microsoft docs.
Preview release notes are always in a `preview` folder. This approach was adopted so that preview releases do not distract from stable releases once preview releases are no longer relevant.
## Supported OS
Supported OS information is published for each major release. This information indicates to users which OSes they can expect an app (or the .NET SDK) to run on for a given .NET version. It also indicates which OSes are supported and when they transitioned to EOL status.
Examples:
- [.NET 8 Supported OSes (json)](./8.0/supported-os.json)
- [.NET 8 Supported OSes (markdown)](./8.0/supported-os.md)
## OS packages
OS package information is published for each major release. This information indicates which packages must be installed on a given distro for a .NET app (or the .NET SDK) to run. [.NET packages](../linux.md) are available for multiple distros, which automatically install all required packages.
Examples:
- [.NET 9 OS packages (json)](./9.0/os-packages.json)
- [.NET 9 OS packages (markdown)](./9.0/os-packages.md)