From b9421cf0b5ea0d8ac23e9f597ffe1212dfafd571 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Wed, 29 Apr 2026 15:24:09 -0700 Subject: [PATCH 1/5] take ownership of what's new docs --- .github/CODEOWNERS | 2 +- .openpublishing.redirection.json | 16 ++--- docfx.json | 6 +- docs/index.yml | 3 +- docs/whats-new/index.yml | 104 ------------------------------- 5 files changed, 10 insertions(+), 121 deletions(-) delete mode 100644 docs/whats-new/index.yml diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index e828ad4f88599..0788c62fdf0db 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -27,7 +27,7 @@ /includes/ @dotnet/docs ############ What's new ############### -/docs/whats-new/ @billwagner @dotnet/docs +/docs/whats-new/ @gewarren @dotnet/docs ############ Guides ################ # .NET Core diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index 4b01ea625c33c..a5a41cce2e6d1 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -305,20 +305,12 @@ "redirect_url": "/dotnet/samples-and-tutorials/" }, { - "source_path_from_root": "/docs/whats-new/dotnet-docs-mod0", - "redirect_url": "/dotnet/whats-new" - }, - { - "source_path_from_root": "/docs/whats-new/dotnet-docs-mod1", - "redirect_url": "/dotnet/whats-new" - }, - { - "source_path_from_root": "/docs/whats-new/dotnet-docs-mod2", - "redirect_url": "/dotnet/whats-new" + "source_path_from_root": "/docs/whats-new/dotnet-9-release.md", + "redirect_url": "/dotnet/core/whats-new/dotnet-9/overview" }, { - "source_path_from_root": "/docs/whats-new/dotnet-9-release.md", - "redirect_url": "/dotnet/whats-new" + "source_path_from_root": "/docs/whats-new/index.yml", + "redirect_url": "/dotnet/core/whats-new/dotnet-11/overview" } ] } diff --git a/docfx.json b/docfx.json index 2a3064e0c385d..adf12b4119168 100644 --- a/docfx.json +++ b/docfx.json @@ -349,7 +349,7 @@ "docs/core/tools/**/**.{md,yml}": "meaghanlewis", "docs/core/tutorials/**/**.{md,yml}": "meaghanlewis", "docs/core/versions/**/**.{md,yml}": "billwagner", - "docs/core/whats-new/**/**.{md,yml}": "billwagner", + "docs/core/whats-new/**/**.{md,yml}": "gewarren", "docs/csharp/**/*.{md,yml}": "billwagner", "docs/framework/**/**.{md,yml}": "gewarren", "docs/framework/additional-apis/pos-for-net/**/**.{md,yml}": "TerryWarwick", @@ -414,7 +414,7 @@ "docs/standard/threading/**/**.{md,yml}": "billwagner", "docs/standard/whats-new/**/**.{md,yml}": "gewarren", "docs/visual-basic/**/**.{md,yml}": "billwagner", - "docs/whats-new/**/**.{md,yml}": "billwagner", + "docs/whats-new/**/**.{md,yml}": "gewarren", "includes/**/**.md": "docs" }, "ms.author": { @@ -444,7 +444,7 @@ "docs/core/tools/**/**.{md,yml}": "mosagie", "docs/core/tutorials/**/**.{md,yml}": "mosagie", "docs/core/versions/**/**.{md,yml}": "wiwagn", - "docs/core/whats-new/**/**.{md,yml}": "wiwagn", + "docs/core/whats-new/**/**.{md,yml}": "gewarren", "docs/csharp/**/*.{md,yml}": "wiwagn", "docs/framework/**/**.{md,yml}": "dotnetcontent", "docs/framework/app-domains/**/**.{md,yml}": "gewarren", diff --git a/docs/index.yml b/docs/index.yml index 31719fe4fd8d9..2dbd72e3cba0d 100644 --- a/docs/index.yml +++ b/docs/index.yml @@ -13,6 +13,7 @@ metadata: author: BillWagner ms.author: wiwagn ms.date: 11/07/2025 + ms.custom: updateeachrelease # highlightedContent section (optional) # Maximum of 8 items @@ -26,7 +27,7 @@ highlightedContent: # Card - title: "What's new in .NET" itemType: whats-new - url: whats-new/index.yml + url: core/whats-new/dotnet-11/overview.md # Card - title: "Build AI apps in .NET" itemType: overview diff --git a/docs/whats-new/index.yml b/docs/whats-new/index.yml deleted file mode 100644 index 35dcc45d64f5d..0000000000000 --- a/docs/whats-new/index.yml +++ /dev/null @@ -1,104 +0,0 @@ -### YamlMime:Landing - -title: .NET - what's new? -summary: Welcome to what's new in .NET and .NET docs. Use this page to navigate to different articles that cover new features for a variety of areas. -metadata: - title: .NET what's new? - description: Learn about new .NET features and new and updated content in .NET docs. - ms.date: 02/10/2026 - ms.topic: landing-page -landingContent: -- title: .NET 11 release updates - linkLists: - - linkListType: whats-new - links: - - text: .NET 11 - url: ../core/whats-new/dotnet-11/overview.md - - text: ASP.NET Core 11.0 - url: /aspnet/core/release-notes/aspnetcore-11 -- title: .NET 10 release updates - linkLists: - - linkListType: whats-new - links: - - text: .NET 10 - url: ../core/whats-new/dotnet-10/overview.md - - text: ASP.NET Core 10.0 - url: /aspnet/core/release-notes/aspnetcore-10.0 - - text: .NET MAUI 10 - url: /dotnet/maui/whats-new/dotnet-10 - - text: EF Core 10 - url: /ef/core/what-is-new/ef-core-10.0/whatsnew - - text: Windows Forms 10 - url: /dotnet/desktop/winforms/whats-new/net100 -- title: .NET 9 release updates - linkLists: - - linkListType: whats-new - links: - - text: .NET 9 - url: ../core/whats-new/dotnet-9/overview.md - - text: ASP.NET Core 9.0 - url: /aspnet/core/release-notes/aspnetcore-9.0 - - text: .NET MAUI 9 - url: /dotnet/maui/whats-new/dotnet-9 - - text: EF Core 9 - url: /ef/core/what-is-new/ef-core-9.0/whatsnew - - text: Documentation updates - url: dotnet-9-release.md -- title: Language updates - linkLists: - - linkListType: whats-new - links: - - text: What's new in C# 14 - url: ../csharp/whats-new/csharp-14.md - - text: What's new in F# 10 - url: ../fsharp/whats-new/fsharp-10.md - - text: What's new for Visual Basic - url: ../visual-basic/whats-new/index.md -- title: Contribute to docs - linkLists: - - linkListType: overview - links: - - text: .NET docs repository - url: https://github.com/dotnet/docs/blob/main/README.md - - text: Project structure and labels for issues and pull requests - url: /contribute/dotnet/labels-projects - - text: .NET Foundation - url: https://dotnetfoundation.org/ - - linkListType: concept - links: - - text: Microsoft docs contributor guide - url: /contribute - - text: .NET docs contributor guide - url: /contribute/dotnet/dotnet-contribute -- title: .NET developers - linkLists: - - linkListType: download - links: - - text: Download the .NET SDK - url: https://dotnet.microsoft.com/download - - linkListType: sample - links: - - text: .NET samples browser - url: /samples/browse/?products=dotnet - - linkListType: get-started - links: - - text: .NET on Q&A - url: /answers/products/dotnet - - text: .NET tech community forums - url: https://techcommunity.microsoft.com/category/dotnet - - linkListType: whats-new - links: - - text: Community - url: https://dotnet.microsoft.com/platform/community -- title: Release notes - linkLists: - - linkListType: whats-new - links: - - text: .NET - url: https://github.com/dotnet/core/blob/main/release-notes/README.md - - text: ASP.NET Core 9.0 - url: /aspnet/core/release-notes/aspnetcore-9.0 - - text: Visual Studio 2022 - url: /visualstudio/releases/2022/release-notes - - text: Visual Studio Code - url: https://code.visualstudio.com/updates From 756e001416f1b339f70577ddbd117551cf65ddf2 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Wed, 29 Apr 2026 15:25:47 -0700 Subject: [PATCH 2/5] delete toc too --- docs/whats-new/toc.yml | 44 ------------------------------------------ 1 file changed, 44 deletions(-) delete mode 100644 docs/whats-new/toc.yml diff --git a/docs/whats-new/toc.yml b/docs/whats-new/toc.yml deleted file mode 100644 index 25beb929b2c21..0000000000000 --- a/docs/whats-new/toc.yml +++ /dev/null @@ -1,44 +0,0 @@ -items: -- name: What's new - href: index.yml - expanded: true - items: - - name: Product updates - items: - - name: .NET 10 - expanded: true - items: - - name: .NET 10 - href: ../core/whats-new/dotnet-10/overview.md?toc=/dotnet/whats-new/toc.json&bc=/dotnet/breadcrumb/toc.json - - name: C# 13 - href: /dotnet/csharp/whats-new/csharp-13?toc=/dotnet/whats-new/toc.json&bc=/dotnet/breadcrumb/toc.json - - name: ASP.NET Core 10.0 - href: /aspnet/core/release-notes/aspnetcore-10.0?toc=/dotnet/whats-new/toc.json&bc=/dotnet/breadcrumb/toc.json - - name: EF Core 10 - href: /ef/core/what-is-new/ef-core-10.0/whatsnew?toc=/dotnet/whats-new/toc.json&bc=/dotnet/breadcrumb/toc.json - - name: .NET 9 - items: - - name: .NET 9 - href: ../core/whats-new/dotnet-9/overview.md?toc=/dotnet/whats-new/toc.json&bc=/dotnet/breadcrumb/toc.json - - name: C# 12 - href: /dotnet/csharp/whats-new/csharp-12?toc=/dotnet/whats-new/toc.json&bc=/dotnet/breadcrumb/toc.json - - name: ASP.NET Core 9.0 - href: /aspnet/core/release-notes/aspnetcore-9.0?toc=/dotnet/whats-new/toc.json&bc=/dotnet/breadcrumb/toc.json - - name: .NET MAUI 9 - href: /dotnet/maui/whats-new/dotnet-9?toc=/dotnet/whats-new/toc.json&bc=/dotnet/breadcrumb/toc.json - - name: EF Core 9 - href: /ef/core/what-is-new/ef-core-9.0/whatsnew?toc=/dotnet/whats-new/toc.json&bc=/dotnet/breadcrumb/toc.json - - name: .NET 8 - items: - - name: .NET 8 - href: ../core/whats-new/dotnet-8/overview.md?toc=/dotnet/whats-new/toc.json&bc=/dotnet/breadcrumb/toc.json - - name: C# 11 - href: /dotnet/csharp/whats-new/csharp-11?toc=/dotnet/whats-new/toc.json&bc=/dotnet/breadcrumb/toc.json - - name: ASP.NET Core 8.0 - href: /aspnet/core/release-notes/aspnetcore-8.0?toc=/dotnet/whats-new/toc.json&bc=/dotnet/breadcrumb/toc.json - - name: Windows Forms (.NET 8) - href: /dotnet/desktop/winforms/whats-new/net80 - - name: .NET MAUI 8 - href: /dotnet/maui/whats-new/dotnet-8?toc=/dotnet/whats-new/toc.json&bc=/dotnet/breadcrumb/toc.json - - name: EF Core 8 - href: /ef/core/what-is-new/ef-core-8.0/whatsnew?toc=/dotnet/whats-new/toc.json&bc=/dotnet/breadcrumb/toc.json From 58652892a6adcce92b51a0381e65d78be13327a8 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Wed, 29 Apr 2026 15:34:46 -0700 Subject: [PATCH 3/5] respond to feedback and remove aspire/training cards --- docs/index.yml | 12 ++---------- docs/toc.yml | 2 -- 2 files changed, 2 insertions(+), 12 deletions(-) diff --git a/docs/index.yml b/docs/index.yml index 2dbd72e3cba0d..48d23ff62d6de 100644 --- a/docs/index.yml +++ b/docs/index.yml @@ -33,14 +33,6 @@ highlightedContent: itemType: overview url: ai/index.yml # Card - - title: Aspire - itemType: overview - url: https://aspire.dev/ - # Card - - title: "Build .NET apps with C#" - itemType: learn - url: /training/paths/build-dotnet-applications-csharp - # Card - title: "Interactive introduction to C#" itemType: get-started url: csharp/tour-of-csharp/tutorials/hello-world.md @@ -68,9 +60,9 @@ conceptualContent: - url: core/tutorials/index.md itemType: tutorial text: .NET tutorials - - url: core/whats-new/dotnet-10/overview.md + - url: core/whats-new/dotnet-11/overview.md itemType: whats-new - text: What's new in .NET 10 + text: What's new in .NET 11 - url: https://dotnetfoundation.org itemType: overview text: .NET Foundation diff --git a/docs/toc.yml b/docs/toc.yml index e94eb7631defd..562b66d34cf42 100644 --- a/docs/toc.yml +++ b/docs/toc.yml @@ -1,8 +1,6 @@ items: - name: Welcome href: welcome.md -- name: What's new in .NET - href: whats-new/index.yml - name: .NET fundamentals href: fundamentals/ - name: .NET Framework guide From c1b96f8bbb40a65ed2a0e60e9d327748f731452e Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Wed, 29 Apr 2026 15:41:58 -0700 Subject: [PATCH 4/5] fix codeowners file --- .github/CODEOWNERS | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index 0788c62fdf0db..9735a902b9f7a 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -82,16 +82,16 @@ /docs/azure/sdk/authentication/ @JonathanCrd @christothes @dotnet/docs @alexwolfmsft @scottaddie # Azure SDK miscellaneous topics -/docs/azure/sdk/azure-sdk-configure-proxy.md @annelo-msft @christothes @JoshLove-msft @KrzysztofCwalina @jsquire @alexwolfmsft @scottaddie @dotnet/docs +/docs/azure/sdk/azure-sdk-configure-proxy.md @christothes @JoshLove-msft @KrzysztofCwalina @jsquire @alexwolfmsft @scottaddie @dotnet/docs /docs/azure/sdk/azure-sdk-for-net.md @jsquire @alexwolfmsft @scottaddie @dotnet/docs /docs/azure/sdk/dependency-injection.md @JoshLove-msft @jsquire @alexwolfmsft @scottaddie @dotnet/docs -/docs/azure/sdk/logging.md @annelo-msft @christothes @JoshLove-msft @KrzysztofCwalina @jsquire @alexwolfmsft +/docs/azure/sdk/logging.md @christothes @JoshLove-msft @KrzysztofCwalina @jsquire @alexwolfmsft /docs/azure/sdk/packages.md @jsquire @alexwolfmsft @scottaddie @dotnet/docs -/docs/azure/sdk/pagination.md @annelo-msft @christothes @JoshLove-msft @KrzysztofCwalina @jsquire @alexwolfmsft @scottaddie @dotnet/docs -/docs/azure/sdk/protocol-convenience-methods.md @annelo-msft @jsquire @alexwolfmsft @scottaddie @dotnet/docs +/docs/azure/sdk/pagination.md @christothes @JoshLove-msft @KrzysztofCwalina @jsquire @alexwolfmsft @scottaddie @dotnet/docs +/docs/azure/sdk/protocol-convenience-methods.md @jsquire @alexwolfmsft @scottaddie @dotnet/docs /docs/azure/sdk/resource-management.md @ArthurMa1978 @m-nash @alexwolfmsft @scottaddie @dotnet/docs -/docs/azure/sdk/thread-safety.md @annelo-msft @christothes @JoshLove-msft @KrzysztofCwalina @jsquire @alexwolfmsft @scottaddie @dotnet/docs -/docs/azure/sdk/unit-testing-mocking.md @annelo-msft @christothes @JoshLove-msft @KrzysztofCwalina @jsquire @alexwolfmsft @scottaddie @dotnet/docs +/docs/azure/sdk/thread-safety.md @christothes @JoshLove-msft @KrzysztofCwalina @jsquire @alexwolfmsft @scottaddie @dotnet/docs +/docs/azure/sdk/unit-testing-mocking.md @christothes @JoshLove-msft @KrzysztofCwalina @jsquire @alexwolfmsft @scottaddie @dotnet/docs ############### Fundamentals ################ From d0a0142761af03a195b3ffae09d30231df76df16 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Thu, 30 Apr 2026 10:33:56 -0700 Subject: [PATCH 5/5] couple more updates --- docs/AGENTS.md | 6 ++++++ docs/welcome.md | 13 +++++-------- 2 files changed, 11 insertions(+), 8 deletions(-) diff --git a/docs/AGENTS.md b/docs/AGENTS.md index 0f143ea20b2e4..b94d8be6416db 100644 --- a/docs/AGENTS.md +++ b/docs/AGENTS.md @@ -5,9 +5,15 @@ Updated December 18th 2025 This is a list of important software releases that an AI model might not be aware of. +- .NET 11 previews have been released monthly since February 2026 + - Reference: [What's new in .NET 11 Overview](https://learn.microsoft.com/en-us/dotnet/core/whats-new/dotnet-11/overview) + - Reference: [What's new in .NET 11 Runtime](https://learn.microsoft.com/en-us/dotnet/core/whats-new/dotnet-11/runtime) + - Reference: [What's new in .NET 11 Libraries](https://learn.microsoft.com/en-us/dotnet/core/whats-new/dotnet-11/libraries) + - Reference: [What's new in .NET 11 SDK](https://learn.microsoft.com/en-us/dotnet/core/whats-new/dotnet-11/sdk) - .NET 10 was released in November 2025 - Reference: [What's new in .NET 10 Overview](https://learn.microsoft.com/en-us/dotnet/core/whats-new/dotnet-10/overview) - Reference: [What's new in .NET 10 Runtime](https://learn.microsoft.com/en-us/dotnet/core/whats-new/dotnet-10/runtime) + - Reference: [What's new in .NET 10 Libraries](https://learn.microsoft.com/en-us/dotnet/core/whats-new/dotnet-10/libraries) - Reference: [What's new in .NET 10 SDK](https://learn.microsoft.com/en-us/dotnet/core/whats-new/dotnet-10/sdk) - Visual Studio 2026 was released in September 2025 - Reference: [Visual Studio 2026 Release Notes](https://learn.microsoft.com/en-us/visualstudio/releases/2026/release-notes) diff --git a/docs/welcome.md b/docs/welcome.md index c5e2111f5320d..1c946aa9b9fff 100644 --- a/docs/welcome.md +++ b/docs/welcome.md @@ -1,7 +1,7 @@ --- title: Welcome to .NET -description: Getting started with the .NET family of technologies. -ms.date: 11/07/2025 +description: Learn how to get started with the .NET family of technologies. +ms.date: 04/30/2026 ms.custom: "updateeachrelease" --- # Welcome to .NET @@ -25,10 +25,9 @@ Also follow the latest .NET events: For information about the latest features added to the .NET implementations and supported languages, see the following articles: -- [What's new in .NET 10](core/whats-new/dotnet-10/overview.md) -- [What's new in C# 14](./csharp/whats-new/csharp-14.md) +- [What's new in .NET 11](core/whats-new/dotnet-11/overview.md) +- [What's new in C# 15](./csharp/whats-new/csharp-15.md) - [What's new for Visual Basic](visual-basic/whats-new/index.md) -- [What's new in .NET Framework](framework/whats-new/index.md) ## Documentation @@ -55,12 +54,10 @@ Explore videos on web, mobile, desktop, C#, machine learning, containers/Docker, This documentation is completely [open source](https://github.com/dotnet/docs). You can contribute in any way you like, from creating issues to writing documentation. Additionally, much of .NET itself is also open source. The following list shows the main .NET GitHub repositories: - [.NET runtime](https://github.com/dotnet/runtime) -- [.NET SDK](https://github.com/dotnet/sdk) +- [.NET SDK and analyzers](https://github.com/dotnet/sdk) - [.NET extensions](https://github.com/dotnet/extensions) - [ASP.NET Core](https://github.com/dotnet/aspnetcore) -- [Aspire](https://github.com/dotnet/aspire) - [Roslyn (C# and Visual Basic) Compiler Platform and IDE Tools](https://github.com/dotnet/roslyn) -- [.NET code analyzers](https://github.com/dotnet/roslyn-analyzers) - [F# Compiler and IDE Tools](https://github.com/dotnet/fsharp) - [Windows Forms](https://github.com/dotnet/winforms) - [WPF](https://github.com/dotnet/wpf)