Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
153 changes: 58 additions & 95 deletions docs/whats-new/dotnet-docs-mod2.md
Original file line number Diff line number Diff line change
@@ -1,145 +1,108 @@
---
title: ".NET docs: What's new for May 2023"
description: "What's new in the .NET docs for May 2023."
ms.custom: May-2023
ms.date: 06/01/2023
title: ".NET docs: What's new for August 2023"
description: "What's new in the .NET docs for August 2023."
ms.custom: August-2023
ms.date: 09/01/2023
---

# .NET docs: What's new for May 2023
# .NET docs: What's new for August 2023

Welcome to what's new in the .NET docs for May 2023. This article lists some of the major changes to docs during this period.
Welcome to what's new in the .NET docs for August 2023. This article lists some of the major changes to docs during this period.

## .NET breaking changes

### New articles

- [Rate-limiting middleware requires AddRateLimiter](../core/compatibility/aspnet-core/8.0/addratelimiter-requirement.md)
- [ISystemClock is obsolete](../core/compatibility/aspnet-core/8.0/isystemclock-obsolete.md)
- [System.Drawing.Common config switch removed](../core/compatibility/core-libraries/7.0/system-drawing.md)
- [Date and time converters honor culture argument](../core/compatibility/globalization/8.0/typeconverter-cultureinfo.md)
- [ConcurrencyLimiterMiddleware is obsolete](../core/compatibility/aspnet-core/8.0/concurrencylimitermiddleware-obsolete.md)
- [Custom converters for serialization removed](../core/compatibility/aspnet-core/8.0/problemdetails-custom-converters.md)
- [StripSymbols defaults to true](../core/compatibility/deployment/8.0/stripsymbols-default.md)
- [GC.GetGeneration might return Int32.MaxValue](../core/compatibility/core-libraries/8.0/getgeneration-return-value.md)
- [API obsoletions with non-default diagnostic IDs (.NET 8)](../core/compatibility/core-libraries/8.0/obsolete-apis-with-custom-diagnostics.md)
- [BinaryFormatter disabled across most project types](../core/compatibility/serialization/8.0/binaryformatter-disabled.md)

### Updated articles

- [Breaking changes in .NET 8](../core/compatibility/8.0.md)
- Add EF Core breaking changes
- Document Preview 5 breaking changes for ASP.NET
- BinaryFormatter disabled & obsoletion of legacy serialization APIs
- StripSymbols default for PublishAOT
- ConvertTo breaking change
- add getgeneration breaking change
- Two ASP.NET breaking changes for .NET 8
- [Breaking changes in .NET 7](../core/compatibility/7.0.md) - System.Drawing.Common config switch removal
- [IDispatchImplAttribute API is removed](../core/compatibility/interop/8.0/idispatchimplattribute-removed.md)
- [Method builders generate parameters with HasDefaultValue set to false](../core/compatibility/core-libraries/8.0/parameterinfo-hasdefaultvalue.md)
- [ConfigurationManager package no longer references System.Security.Permissions](../core/compatibility/extensions/8.0/configurationmanager-package.md)
- [DirectoryServices package no longer references System.Security.Permissions](../core/compatibility/extensions/8.0/directoryservices-package.md)
- [Trimming may not be used with .NET standard or .NET framework](../core/compatibility/sdk/8.0/trimming-unsupported-targetframework.md)
- ['dotnet restore' produces security vulnerability warnings](../core/compatibility/sdk/8.0/dotnet-restore-audit.md)
- [.NET can't be installed to custom location](../core/compatibility/sdk/6.0/install-location.md)
- [Boolean-backed enum type support removed](../core/compatibility/core-libraries/8.0/bool-backed-enum.md)
- [Binding config to dictionary extends values](../core/compatibility/extensions/7.0/config-bind-dictionary.md)
- ['ca-certificates' and 'krb5-libs' packages removed from Alpine images](../core/compatibility/containers/8.0/krb5-libs-package.md)
- [Removed Boolean-based overloads of ToFrozenDictionary/ToFrozenSet](../core/compatibility/core-libraries/8.0/optimizeforreading-arg.md)
- [Security token events return a JSonWebToken](../core/compatibility/aspnet-core/8.0/securitytoken-events.md)
- [TrimMode defaults to full for Web SDK projects](../core/compatibility/aspnet-core/8.0/trimmode-full.md)

## .NET Framework

### Updated articles

- [Certmgr.exe (Certificate Manager Tool)](../framework/tools/certmgr-exe-certificate-manager-tool.md) - Clarify installation location for certmgr.exe
- [Security Protocols version 1.0](../framework/wcf/feature-details/security-protocols-version-1-0.md) - Fix build suggestions
- [\<defaultProxy> element (network settings)](../framework/configure-apps/file-schema/network/defaultproxy-element-network-settings.md) - Add link to DefaultProxy property

## .NET fundamentals

### New articles

- [How to use a JSON document in System.Text.Json](../standard/serialization/system-text-json/use-dom.md)
- [How to use Utf8JsonReader in System.Text.Json](../standard/serialization/system-text-json/use-utf8jsonreader.md)
- [How to use Utf8JsonWriter in System.Text.Json](../standard/serialization/system-text-json/use-utf8jsonwriter.md)
- [Troubleshoot QUIC issues in .NET](../fundamentals/networking/quic/quic-troubleshooting.md)
- [Install .NET SDK or .NET Runtime on Ubuntu 23.04](../core/install/linux-ubuntu-2304.md)
- [Logging guidance for .NET library authors](../core/extensions/logging-library-authors.md)

### Updated articles

- [What's new in .NET 8](../core/whats-new/dotnet-8.md) - Update What's new in .NET 8 for Preview 4
- [Grouping constructs in regular expressions](../standard/base-types/grouping-constructs-in-regular-expressions.md) - Clarify named capture group order
- [Tutorial: Debug a .NET console application using Visual Studio](../core/tutorials/debugging-with-visual-studio.md) - Update Visual Studio tutorial series
- [Tutorial: Create a .NET class library using Visual Studio](../core/tutorials/library-with-visual-studio.md) - Update Visual Studio tutorial series
- [Tutorial: Publish a .NET console application using Visual Studio](../core/tutorials/publishing-with-visual-studio.md) - Update Visual Studio tutorial series
- [Tutorial: Test a .NET class library with .NET using Visual Studio](../core/tutorials/testing-library-with-visual-studio.md) - Update Visual Studio tutorial series
- [Tutorial: Create a .NET console application using Visual Studio](../core/tutorials/with-visual-studio.md) - Update Visual Studio tutorial series
- [What's new in .NET 8](../core/whats-new/dotnet-8.md) - Update What's new in .NET 8 for Preview 7

## .NET tools and diagnostics

### New articles

- [SYSLIB diagnostics for COM interop source generation](../fundamentals/syslib-diagnostics/syslib1090-1099.md)
- [SYSLIB diagnostics for configuration binder source generation](../fundamentals/syslib-diagnostics/syslib1100-1118.md)
- [SYSLIB0050: Formatter-based serialization is obsolete](../fundamentals/syslib-diagnostics/syslib0050.md)
- [SYSLIB0051: Legacy serialization support APIs are obsolete](../fundamentals/syslib-diagnostics/syslib0051.md)
- [CA1859: Use concrete types when possible for improved performance](../fundamentals/code-analysis/quality-rules/ca1859.md)
- [CA1861: Avoid constant arrays as arguments](../fundamentals/code-analysis/quality-rules/ca1861.md)

### Updated articles

- [Source-generator diagnostics in .NET 6+](../fundamentals/syslib-diagnostics/source-generator-overview.md) - Add redirects for SYSLIB warnings

## C# language

### New articles

- [Resolve errors and warnings in constructor declarations](../csharp/language-reference/compiler-messages/constructor-errors.md)
- [Errors and warnings when using lambda expressions and anonymous functions](../csharp/language-reference/compiler-messages/lambda-expression-errors.md)
- [Resolve warnings related using namespaces](../csharp/language-reference/compiler-messages/using-directive-errors.md)
- [NETSDK1206: Found version-specific or distribution-specific runtime identifier(s)](../core/tools/sdk-errors/netsdk1206.md)
- [CA1869: Cache and reuse 'JsonSerializerOptions' instances](../fundamentals/code-analysis/quality-rules/ca1869.md)
- [Use 'nameof' (IDE0280)](../fundamentals/code-analysis/style-rules/ide0280.md)

### Updated articles

- [Using Constructors (C# Programming Guide)](../csharp/programming-guide/classes-and-structs/using-constructors.md) - Ret con primary record constructors
- [Creating Metrics](../core/diagnostics/metrics-instrumentation.md) - Update metrics for .NET 8 changes
- [Rule categories](../fundamentals/code-analysis/categories.md) - Clarify MSBuild vs. editorconfig bulk config

## DevOps and testing in .NET
## Advanced .NET programming

### New articles

- [Native code interop with native AOT](../core/deploying/native-aot/interop.md)
- [Unmanaged calling conventions](../standard/native-interop/calling-conventions.md)

## Microsoft Orleans
## C# language

### New articles

- [Grain extensions](../orleans/grains/grain-extensions.md)
- [Resolve errors and warnings in array declarations and initialization expressions](../csharp/language-reference/compiler-messages/array-declaration-errors.md)
- [Arrays](../csharp/language-reference/builtin-types/arrays.md)
- [Collections](../csharp/language-reference/builtin-types/collections.md)
- [Collection expressions - C# language reference](../csharp/language-reference/operators/collection-expressions.md)

## Migration to .NET
## DevOps and testing in .NET

### New articles

- [Install the .NET Upgrade Assistant](../core/porting/upgrade-assistant-install.md)
- [Diagnostics in native AOT applications](../core/deploying/native-aot/diagnostics.md)

### Updated articles

- [Overview of the .NET Upgrade Assistant](../core/porting/upgrade-assistant-overview.md)
- Add UA CLI area to docs
- Add the upgrade assistant docs for Visual Studio
- [Prepare .NET libraries for trimming](../core/deploying/trimming/prepare-libraries-for-trimming.md) - Update trimming doc

## Community contributors

The following people contributed to the .NET docs during this period. Thank you! Learn how to contribute by following the links under "Get involved" in the [what's new landing page](index.yml).

- [cartermp](https://github.com/cartermp) - Phillip Carter ![There were 9 pull requests merged by Phillip Carter.](https://img.shields.io/badge/Merged%20Pull%20Requests-9-green)
- [pkulikov](https://github.com/pkulikov) - Petr Kulikov ![There were 8 pull requests merged by Petr Kulikov.](https://img.shields.io/badge/Merged%20Pull%20Requests-8-green)
- [ShinyZero0](https://github.com/ShinyZero0) - ![There were 3 pull requests merged by .](https://img.shields.io/badge/Merged%20Pull%20Requests-3-green)
- [ali50m](https://github.com/ali50m) - ![There were 2 pull requests merged by .](https://img.shields.io/badge/Merged%20Pull%20Requests-2-green)
- [BartoszKlonowski](https://github.com/BartoszKlonowski) - Bartosz Klonowski ![There were 2 pull requests merged by Bartosz Klonowski.](https://img.shields.io/badge/Merged%20Pull%20Requests-2-green)
- [cid25](https://github.com/cid25) - ![There were 2 pull requests merged by .](https://img.shields.io/badge/Merged%20Pull%20Requests-2-green)
- [mahab339](https://github.com/mahab339) - Muhab Abdelreheem ![There were 2 pull requests merged by Muhab Abdelreheem.](https://img.shields.io/badge/Merged%20Pull%20Requests-2-green)
- [tonesoutherland](https://github.com/tonesoutherland) - Tone Southerland ![There were 2 pull requests merged by Tone Southerland.](https://img.shields.io/badge/Merged%20Pull%20Requests-2-green)
- [ablanchet](https://github.com/ablanchet) - Antoine Blanchet ![There were 1 pull requests merged by Antoine Blanchet.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [ACGNnsj](https://github.com/ACGNnsj) - Shijie Ni ![There were 1 pull requests merged by Shijie Ni.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [Adi9235](https://github.com/Adi9235) - Aditya Tomar ![There were 1 pull requests merged by Aditya Tomar.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [andreycha](https://github.com/andreycha) - Andrei Chasovskikh ![There were 1 pull requests merged by Andrei Chasovskikh.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [ardalis](https://github.com/ardalis) - Steve Smith ![There were 1 pull requests merged by Steve Smith.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [bartelink](https://github.com/bartelink) - Ruben Bartelink ![There were 1 pull requests merged by Ruben Bartelink.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [chrisxfire](https://github.com/chrisxfire) - Christian ![There were 1 pull requests merged by Christian.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [cmeeren](https://github.com/cmeeren) - Christer van der Meeren ![There were 1 pull requests merged by Christer van der Meeren.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [dahermansson](https://github.com/dahermansson) - Hermansson ![There were 1 pull requests merged by Hermansson.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [Davi-Gray](https://github.com/Davi-Gray) - Davi Gray ![There were 1 pull requests merged by Davi Gray.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [dawedawe](https://github.com/dawedawe) - dawe ![There were 1 pull requests merged by dawe.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [DickBaker](https://github.com/DickBaker) - Dick Baker ![There were 1 pull requests merged by Dick Baker.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [ericmutta](https://github.com/ericmutta) - Eric Mutta ![There were 1 pull requests merged by Eric Mutta.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [galvesribeiro](https://github.com/galvesribeiro) - Gutemberg Ribeiro ![There were 1 pull requests merged by Gutemberg Ribeiro.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [haoguanjun](https://github.com/haoguanjun) - ![There were 1 pull requests merged by .](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [jeanrp](https://github.com/jeanrp) - Jean Pinto ![There were 1 pull requests merged by Jean Pinto.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [just-a-hriday](https://github.com/just-a-hriday) - Hriday A ![There were 1 pull requests merged by Hriday A.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [marleypowell](https://github.com/marleypowell) - Marley ![There were 1 pull requests merged by Marley.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [Smaug123](https://github.com/Smaug123) - Patrick Stevens ![There were 1 pull requests merged by Patrick Stevens.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [startewho](https://github.com/startewho) - ![There were 1 pull requests merged by .](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [steveberdy](https://github.com/steveberdy) - Steve Berdy ![There were 1 pull requests merged by Steve Berdy.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [taibu](https://github.com/taibu) - ISABIRYE TAIBU ![There were 1 pull requests merged by ISABIRYE TAIBU.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [Zerthz](https://github.com/Zerthz) - Felix ![There were 1 pull requests merged by Felix.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [BartoszKlonowski](https://github.com/BartoszKlonowski) - Bartosz Klonowski ![5 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-5-green)
- [ar1k](https://github.com/ar1k) - Aleksandr Ananin ![3 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-3-green)
- [FrediKats](https://github.com/FrediKats) - Fredi Kats ![2 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-2-green)
- [pkulikov](https://github.com/pkulikov) - Petr Kulikov ![2 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-2-green)
- [angrypig555](https://github.com/angrypig555) - ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [Bafyn](https://github.com/Bafyn) - Dmytro Nikitin ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [bitbonk](https://github.com/bitbonk) - bitbonk ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [dandev486](https://github.com/dandev486) - dandev486 ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [dimitriskad](https://github.com/dimitriskad) - Dimitris K. ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [EugeneGritsina](https://github.com/EugeneGritsina) - Eugene Gritsina ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [Happypig375](https://github.com/Happypig375) - Hadrian Tang ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [mikaeldui](https://github.com/mikaeldui) - Mikael Dúi Bolinder ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [SugarBarrel](https://github.com/SugarBarrel) - Abbysssal ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [tanchekwei](https://github.com/tanchekwei) - Chek Wei Tan ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
- [weierstrass1031](https://github.com/weierstrass1031) - ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green)
6 changes: 3 additions & 3 deletions docs/whats-new/index.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ summary: Welcome to what's new in .NET docs. Use this page to quickly find the l
metadata:
title: .NET documentation what's new?
description: Learn about new and updated content in .NET docs.
ms.date: 08/01/2023
ms.date: 09/01/2023
ms.topic: landing-page
landingContent:
- title: .NET release updates
Expand All @@ -18,12 +18,12 @@ landingContent:
linkLists:
- linkListType: whats-new
links:
- text: August 2023
url: dotnet-docs-mod2.md
- text: July 2023
url: dotnet-docs-mod1.md
- text: June 2023
url: dotnet-docs-mod0.md
- text: May 2023
url: dotnet-docs-mod2.md
- title: Find language updates
linkLists:
- linkListType: whats-new
Expand Down
4 changes: 2 additions & 2 deletions docs/whats-new/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@ items:
- name: Latest documentation updates
expanded: true
items:
- name: August 2023
href: dotnet-docs-mod2.md
- name: July 2023
href: dotnet-docs-mod1.md
- name: June 2023
href: dotnet-docs-mod0.md
- name: May 2023
href: dotnet-docs-mod2.md