Skip to content

Commit fbb2dab

Browse files
authored
Add bookmark indexes to breaking changes docs (#16663)
* add bookmark indexes * fix build warnings * fix closing html tag * feedback from maira
1 parent d9d185d commit fbb2dab

18 files changed

+377
-37
lines changed

docs/core/compatibility/2.0-2.1.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,4 +9,8 @@ If you're migrating from version 2.0 to version 2.1 of .NET Core, the breaking c
99

1010
## CoreFx
1111

12-
[!INCLUDE[Instantiate struct](~/includes/core-changes/corefx/2.1/instantiate-struct.md)]
12+
- [Private fields added to built-in struct types](#private-fields-added-to-built-in-struct-types)
13+
14+
[!INCLUDE[Private fields added to built-in struct types](~/includes/core-changes/corefx/2.1/instantiate-struct.md)]
15+
16+
***

docs/core/compatibility/2.2-3.0.md

Lines changed: 105 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,58 @@ If you're migrating from version 2.2 to version 3.0 of .NET Core, ASP.NET Core,
99

1010
## ASP.NET Core
1111

12-
[!INCLUDE[obsolete Antiforgery, CORS, Diagnostics, MVC, and Routing APIs removed](~/includes/core-changes/aspnetcore/3.0/obsolete-apis-removed.md)]
12+
- [Obsolete Antiforgery, CORS, Diagnostics, MVC, and Routing APIs removed](#obsolete-antiforgery-cors-diagnostics-mvc-and-routing-apis-removed)
13+
- [Authentication: Google+ deprecation](#authentication-google-deprecated-and-replaced)
14+
- [Authentication: HttpContext.Authentication property removed](#authentication-httpcontextauthentication-property-removed)
15+
- [Authentication: Newtonsoft.Json types replaced](#authentication-newtonsoftjson-types-replaced)
16+
- [Authentication: OAuthHandler ExchangeCodeAsync signature changed](#authentication-oauthhandler-exchangecodeasync-signature-changed)
17+
- [Authorization: AddAuthorization overload moved to different assembly](#authorization-addauthorization-overload-moved-to-different-assembly)
18+
- [Authorization: IAllowAnonymous removed from AuthorizationFilterContext.Filters](#authorization-iallowanonymous-removed-from-authorizationfiltercontextfilters)
19+
- [Authorization: IAuthorizationPolicyProvider implementations require new method](#authorization-iauthorizationpolicyprovider-implementations-require-new-method)
20+
- [Caching: CompactOnMemoryPressure property removed](#caching-compactonmemorypressure-property-removed)
21+
- [Caching: Microsoft.Extensions.Caching.SqlServer uses new SqlClient package](#caching-microsoftextensionscachingsqlserver-uses-new-sqlclient-package)
22+
- [Caching: ResponseCaching "pubternal" types changed to internal](#caching-responsecaching-pubternal-types-changed-to-internal)
23+
- [Data Protection: DataProtection.AzureStorage uses new Azure Storage APIs](#data-protection-dataprotectionazurestorage-uses-new-azure-storage-apis)
24+
- [Hosting: AspNetCoreModule V1 removed from Windows Hosting Bundle](#hosting-aspnetcoremodule-v1-removed-from-windows-hosting-bundle)
25+
- [Hosting: Generic host restricts Startup constructor injection](#hosting-generic-host-restricts-startup-constructor-injection)
26+
- [Hosting: HTTPS redirection enabled for IIS out-of-process apps](#hosting-https-redirection-enabled-for-iis-out-of-process-apps)
27+
- [Hosting: IHostingEnvironment and IApplicationLifetime types replaced](#hosting-ihostingenvironment-and-iapplicationlifetime-types-marked-obsolete-and-replaced)
28+
- [Hosting: ObjectPoolProvider removed from WebHostBuilder dependencies](#hosting-objectpoolprovider-removed-from-webhostbuilder-dependencies)
29+
- [HTTP: DefaultHttpContext extensibility removed](#http-defaulthttpcontext-extensibility-removed)
30+
- [HTTP: HeaderNames fields changed to static readonly](#http-headernames-constants-changed-to-static-readonly)
31+
- [HTTP: Response body infrastructure changes](#http-response-body-infrastructure-changes)
32+
- [HTTP: Some cookie SameSite default values changed](#http-some-cookie-samesite-defaults-changed-to-none)
33+
- [HTTP: Synchronous IO disabled by default](#http-synchronous-io-disabled-in-all-servers)
34+
- [Identity: AddDefaultUI method overload removed](#identity-adddefaultui-method-overload-removed)
35+
- [Identity: UI Bootstrap version change](#identity-default-bootstrap-version-of-ui-changed)
36+
- [Identity: SignInAsync throws exception for unauthenticated identity](#identity-signinasync-throws-exception-for-unauthenticated-identity)
37+
- [Identity: SignInManager constructor accepts new parameter](#identity-signinmanager-constructor-accepts-new-parameter)
38+
- [Identity: UI uses static web assets feature](#identity-ui-uses-static-web-assets-feature)
39+
- [Kestrel: Connection adapters removed](#kestrel-connection-adapters-removed)
40+
- [Kestrel: Empty HTTPS assembly removed](#kestrel-empty-https-assembly-removed)
41+
- [Kestrel: Request trailer headers moved to new collection](#kestrel-request-trailer-headers-moved-to-new-collection)
42+
- [Kestrel: Transport abstraction layer changes](#kestrel-transport-abstractions-removed-and-made-public)
43+
- [Localization: APIs marked obsolete](#localization-resourcemanagerwithculturestringlocalizer-and-withculture-marked-obsolete)
44+
- [Logging: DebugLogger class made internal](#logging-debuglogger-class-made-internal)
45+
- [MVC: Controller action Async suffix removed](#mvc-async-suffix-trimmed-from-controller-action-names)
46+
- [MVC: JsonResult moved to Microsoft.AspNetCore.Mvc.Core](#mvc-jsonresult-moved-to-microsoftaspnetcoremvccore)
47+
- [MVC: Precompilation tool deprecated](#mvc-precompilation-tool-deprecated)
48+
- [MVC: Types changed to internal](#mvc-pubternal-types-changed-to-internal)
49+
- [MVC: Web API compatibility shim removed](#mvc-web-api-compatibility-shim-removed)
50+
- [Razor: Runtime compilation moved to a package](#razor-runtime-compilation-moved-to-a-package)
51+
- [Session state: Obsolete APIs removed](#session-state-obsolete-apis-removed)
52+
- [Shared framework: Assembly removal from Microsoft.AspNetCore.App](#shared-framework-assemblies-removed-from-microsoftaspnetcoreapp)
53+
- [Shared framework: Microsoft.AspNetCore.All removed](#shared-framework-removed-microsoftaspnetcoreall)
54+
- [SignalR: HandshakeProtocol.SuccessHandshakeData replaced](#signalr-handshakeprotocolsuccesshandshakedata-replaced)
55+
- [SignalR: HubConnection methods removed](#signalr-hubconnection-resetsendping-and-resettimeout-methods-removed)
56+
- [SignalR: HubConnectionContext constructors changed](#signalr-hubconnectioncontext-constructors-changed)
57+
- [SignalR: JavaScript client package name change](#signalr-javascript-client-package-name-changed)
58+
- [SignalR: Obsolete APIs](#signalr-usesignalr-and-useconnections-methods-marked-obsolete)
59+
- [SPAs: SpaServices and NodeServices marked obsolete](#spas-spaservices-and-nodeservices-marked-obsolete)
60+
- [SPAs: SpaServices and NodeServices console logger fallback default change](#spas-spaservices-and-nodeservices-no-longer-fall-back-to-console-logger)
61+
- [Target framework: .NET Framework not supported](#target-framework-net-framework-support-dropped)
62+
63+
[!INCLUDE[Obsolete Antiforgery, CORS, Diagnostics, MVC, and Routing APIs removed](~/includes/core-changes/aspnetcore/3.0/obsolete-apis-removed.md)]
1364

1465
***
1566

@@ -207,8 +258,24 @@ If you're migrating from version 2.2 to version 3.0 of .NET Core, ASP.NET Core,
207258

208259
[!INCLUDE[Target framework: .NET Framework not supported](~/includes/core-changes/aspnetcore/3.0/targetfx-netfx-tfm-support.md)]
209260

261+
***
262+
210263
## CoreFx
211264

265+
- [APIs that report version now report product and not file version](#apis-that-report-version-now-report-product-and-not-file-version)
266+
- [Custom EncoderFallbackBuffer instances cannot fall back recursively](#custom-encoderfallbackbuffer-instances-cannot-fall-back-recursively)
267+
- [Floating point formatting and parsing behavior changes](#floating-point-formatting-and-parsing-behavior-changed)
268+
- [Floating-point parsing operations no longer fail or throw an OverflowException](#floating-point-parsing-operations-no-longer-fail-or-throw-an-overflowexception)
269+
- [InvalidAsynchronousStateException moved to another assembly](#invalidasynchronousstateexception-moved-to-another-assembly)
270+
- [NET Core 3.0 follows Unicode best practices when replacing ill-formed UTF-8 byte sequences](#net-core-30-follows-unicode-best-practices-when-replacing-ill-formed-utf-8-byte-sequences)
271+
- [TypeDescriptionProviderAttribute moved to another assembly](#typedescriptionproviderattribute-moved-to-another-assembly)
272+
- [JSON serializer exception type changed from JsonException to NotSupportedException](#json-serializer-exception-type-changed-from-jsonexception-to-notsupportedexception)
273+
- [Change in semantics of (string)null in Utf8JsonWriter](#change-in-semantics-of-stringnull-in-utf8jsonwriter)
274+
- [JsonEncodedText.Encode methods have an additional JavaScriptEncoder argument](#jsonencodedtextencode-methods-have-an-additional-javascriptencoder-argument)
275+
- [JsonFactoryConverter.CreateConverter signature changed](#jsonfactoryconvertercreateconverter-signature-changed)
276+
- [ZipArchiveEntry no longer handles archives with inconsistent entry sizes](#ziparchiveentry-no-longer-handles-archives-with-inconsistent-entry-sizes)
277+
- [JsonElement API changes](#jsonelement-api-changes)
278+
212279
[!INCLUDE[APIs that report version now report product and not file version](~/includes/core-changes/corefx/3.0/version-information-changes.md)]
213280

214281
***
@@ -241,7 +308,7 @@ If you're migrating from version 2.2 to version 3.0 of .NET Core, ASP.NET Core,
241308

242309
***
243310

244-
[!INCLUDE[Json serializer exception type changed from JsonException to NotSupportedException](~/includes/core-changes/corefx/3.0/serializer-throws-notsupportedexception.md)]
311+
[!INCLUDE[JSON serializer exception type changed from JsonException to NotSupportedException](~/includes/core-changes/corefx/3.0/serializer-throws-notsupportedexception.md)]
245312

246313
***
247314

@@ -259,8 +326,15 @@ If you're migrating from version 2.2 to version 3.0 of .NET Core, ASP.NET Core,
259326

260327
[!INCLUDE[JsonElement API changes](~/includes/core-changes/corefx/3.0/jsonelement-api-changes.md)]
261328

329+
***
330+
262331
## Cryptography
263332

333+
- [EnvelopedCms defaults to AES-256 encryption](#envelopedcms-defaults-to-aes-256-encryption)
334+
- [Minimum size for RSAOpenSsl key generation has increased](#minimum-size-for-rsaopenssl-key-generation-has-increased)
335+
- [.NET Core 3.0 prefers OpenSSL 1.1.x to OpenSSL 1.0.x](#net-core-30-prefers-openssl-11x-to-openssl-10x)
336+
- [Better argument validation in the Pkcs8PrivateKeyInfo constructor](#better-argument-validation-in-the-pkcs8privatekeyinfo-constructor)
337+
264338
[!INCLUDE[EnvelopedCms defaults to AES-256 encryption](~/includes/core-changes/cryptography/3.0/envelopedcms-defaults-to-aes256.md)]
265339

266340
***
@@ -275,18 +349,47 @@ If you're migrating from version 2.2 to version 3.0 of .NET Core, ASP.NET Core,
275349

276350
[!INCLUDE[Better argument validation in the Pkcs8PrivateKeyInfo constructor](~/includes/core-changes/cryptography/3.0/better-argument-validation-in-pkcs8privatekeyinfo-ctor.md)]
277351

352+
***
353+
278354
## Entity Framework Core
279355

280356
[Entity Framework Core breaking changes](/ef/core/what-is-new/ef-core-3.0/breaking-changes)
281357

282358
## Globalization
283359

360+
- ["C" locale maps to the invariant locale](#c-locale-maps-to-the-invariant-locale)
361+
284362
[!INCLUDE["C" locale maps to the invariant locale](~/includes/core-changes/globalization/3.0/c-locale-maps-to-invariant-locale.md)]
285363

364+
***
365+
286366
## Networking
287367

368+
- [Default value of HttpRequestMessage.Version changed to 1.1](#default-value-of-httprequestmessageversion-changed-to-11)
369+
288370
[!INCLUDE[Default value of HttpRequestMessage.Version changed to 1.1](~/includes/core-changes/networking/3.0/httprequestmessage-version-change.md)]
289371

372+
***
373+
290374
## Visual Basic
291375

376+
- [Types in Microsoft.VisualBasic.ApplicationServices namespace not available](#types-in-microsoftvisualbasicapplicationservices-namespace-not-available)
377+
- [Types in Microsoft.VisualBasic.Devices namespace not available](#types-in-microsoftvisualbasicdevices-namespace-not-available)
378+
- [Types in Microsoft.VisualBasic.MyServices namespace not available](#types-in-microsoftvisualbasicmyservices-namespace-not-available)
379+
- [Microsoft.VisualBasic.Constants.vbNewLine is obsolete](#microsoftvisualbasicconstantsvbnewline-is-obsolete)
380+
381+
[!INCLUDE[Types in Microsoft.VisualBasic.ApplicationServices namespace not available](~/includes/core-changes/visualbasic/3.0/microsoft.visualbasic.applicationservices-unavailable.md)]
382+
383+
***
384+
385+
[!INCLUDE[Types in Microsoft.VisualBasic.Devices namespace not available](~/includes/core-changes/visualbasic/3.0/microsoft.visualbasic.devices-unavailable.md)]
386+
387+
***
388+
389+
[!INCLUDE[Types in Microsoft.VisualBasic.MyServices namespace not available](~/includes/core-changes/visualbasic/3.0/microsoft.visualbasic.myservices-unavailable.md)]
390+
391+
***
392+
292393
[!INCLUDE[vbNewLine is obsolete](~/includes/core-changes/visualbasic/3.0/vbnewline-is-obsolete.md)]
394+
395+
***

0 commit comments

Comments
 (0)