diff --git a/.github/skills/whats-new-include-content-rules/SKILL.md b/.github/skills/whats-new-include-content-rules/SKILL.md index e619ae81b33b..68eedac7bdde 100644 --- a/.github/skills/whats-new-include-content-rules/SKILL.md +++ b/.github/skills/whats-new-include-content-rules/SKILL.md @@ -25,23 +25,25 @@ All include files go in: * Lowercase, hyphenated, descriptive names using whole words only. * Each word and number must be separated by a hyphen. Do not combine words or abbreviate them, and do not combine numbers with words. - - **Wrong**: `infer-pk-display-name-preview2.md` (`pk` is an abbreviation, and `preview2` combines a word with a number) - - **Correct**: `infer-passkey-display-name-preview-2.md` (whole words, number separated by hyphen) -* Append the preview number suffix to each filename: `-preview-{N}` (where `{N}` is the preview number, e.g., `-preview-2`). - **CRITICAL**: Every new file MUST include the preview suffix. This was a mistake - in the initial automation — a file was created without the suffix and had to be - corrected. + - **Wrong**: `infer-pk-display-name.md` (`pk` is an abbreviation) + - **Correct**: `infer-passkey-display-name.md` (whole words) +* Do NOT append a preview number suffix to the filename. + **CRITICAL**: Never add a `-preview-{N}` suffix. Preview version suffixes cause + confusion when the same feature is updated for a later preview release, and they + aren't needed. Name each file for its feature only (for example, + `async-validation-minimal-apis.md`), and update that same file in place across + preview releases. * Examples: - - `native-otel-tracing-preview-2.md` - - `openapi-3-2-support-preview-2.md` - - `infer-passkey-display-name-preview-2.md` - - `performance-improvements-preview-2.md` + - `native-otel-tracing.md` + - `openapi-3-2-support.md` + - `infer-passkey-display-name.md` + - `performance-improvements.md` ### One file per feature * Create one include file per feature or section. * **Exception — Performance**: Combine all performance improvements into a - single `performance-improvements-preview-{N}.md` file. + single `performance-improvements.md` file. ### Exclusions — do NOT create include files for @@ -163,7 +165,7 @@ release notes. Reformat and de-duplicate, but do not summarize away information. Before completing, verify: -- [ ] Every new include filename ends with `-preview-{N}`. +- [ ] No include filename has a `-preview-{N}` suffix. - [ ] Every word and number in filenames is separated by a hyphen (no abbreviations, no combined word-numbers). - [ ] No Blazor content was included. - [ ] No bug-fix-only content was included. diff --git a/aspnetcore/release-notes/aspnetcore-11.md b/aspnetcore/release-notes/aspnetcore-11.md index 6049a9b3b4c1..2af92baec447 100644 --- a/aspnetcore/release-notes/aspnetcore-11.md +++ b/aspnetcore/release-notes/aspnetcore-11.md @@ -29,27 +29,27 @@ This section describes new features for Blazor Hybrid. This section describes new features for SignalR. -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/signalr-authentication-refresh-preview-6.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/signalr-authentication-refresh.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/signalr-cancel-hub-invocations-preview-6.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/signalr-cancel-hub-invocations.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/signalr-auth-refresh-redirects-preview-7.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/signalr-auth-refresh-redirects.md)] ## Minimal APIs This section describes new features for Minimal APIs. -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/endpoint-filters-binding-failures-preview4.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/endpoint-filters-binding-failures.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/csharp-unions-preview-6.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/csharp-unions.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/async-validation-minimal-apis-preview-6.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/async-validation-minimal-apis.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/short-circuit-endpoints-attribute-preview-6.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/short-circuit-endpoints-attribute.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/validation-localization-preview-7.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/validation-localization.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/validation-attributes-no-longer-experimental-preview-7.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/validation-attributes-no-longer-experimental.md)] ## OpenAPI @@ -57,17 +57,17 @@ This section describes new features for OpenAPI. [!INCLUDE[](~/release-notes/aspnetcore-11/includes/openapi-binary-file-response.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/openapi-3-2-support-preview2.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/openapi-3-2-support.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/http-query-openapi-preview4.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/http-query-openapi.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/file-result-openapi-preview4.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/file-result-openapi.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/openapi-schema-improvements-preview-5.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/openapi-schema-improvements.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/openapi-3-2-default-preview-6.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/openapi-3-2-default.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/openapi-server-sent-events-preview-7.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/openapi-server-sent-events.md)] [!INCLUDE[](~/release-notes/aspnetcore-11/includes/openapi-generation-environment.md)] @@ -77,11 +77,11 @@ This section describes new features for authentication and authorization. [!INCLUDE[](~/release-notes/aspnetcore-11/includes/identity-time-provider.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/infer-passkey-display-name-preview2.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/infer-passkey-display-name.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/user-jwts-file-based-apps-preview-6.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/user-jwts-file-based-apps.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/consistent-authorization-metadata-preview-7.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/consistent-authorization-metadata.md)] ## Miscellaneous @@ -91,27 +91,27 @@ This section describes miscellaneous new features in .NET 11. [!INCLUDE[](~/release-notes/aspnetcore-11/includes/development-certificate-trust.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/native-otel-tracing-preview2.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/native-otel-tracing.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/performance-improvements-preview2.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/performance-improvements.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/zstandard-compression-preview-3.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/zstandard-compression.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/http3-early-request-processing-preview-3.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/http3-early-request-processing.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/mcp-server-template-preview4.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/mcp-server-template.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/tls-handshake-observability-preview4.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/tls-handshake-observability.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/response-compression-vary-header-preview4.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/response-compression-vary-header.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/runtime-async-shared-framework-preview4.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/runtime-async-shared-framework.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/rate-limiting-retry-after-preview-4.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/rate-limiting-retry-after.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/kestrel-trailer-header-timeouts-preview-5.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/kestrel-trailer-header-timeouts.md)] -[!INCLUDE[](~/release-notes/aspnetcore-11/includes/tls-channel-binding-token-preview-7.md)] +[!INCLUDE[](~/release-notes/aspnetcore-11/includes/tls-channel-binding-token.md)] ## Breaking changes diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/async-validation-minimal-apis-preview-6.md b/aspnetcore/release-notes/aspnetcore-11/includes/async-validation-minimal-apis.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/async-validation-minimal-apis-preview-6.md rename to aspnetcore/release-notes/aspnetcore-11/includes/async-validation-minimal-apis.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/consistent-authorization-metadata-preview-7.md b/aspnetcore/release-notes/aspnetcore-11/includes/consistent-authorization-metadata.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/consistent-authorization-metadata-preview-7.md rename to aspnetcore/release-notes/aspnetcore-11/includes/consistent-authorization-metadata.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/csharp-unions-preview-6.md b/aspnetcore/release-notes/aspnetcore-11/includes/csharp-unions.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/csharp-unions-preview-6.md rename to aspnetcore/release-notes/aspnetcore-11/includes/csharp-unions.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/endpoint-filters-binding-failures-preview4.md b/aspnetcore/release-notes/aspnetcore-11/includes/endpoint-filters-binding-failures.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/endpoint-filters-binding-failures-preview4.md rename to aspnetcore/release-notes/aspnetcore-11/includes/endpoint-filters-binding-failures.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/file-result-openapi-preview4.md b/aspnetcore/release-notes/aspnetcore-11/includes/file-result-openapi.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/file-result-openapi-preview4.md rename to aspnetcore/release-notes/aspnetcore-11/includes/file-result-openapi.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/http-query-openapi-preview4.md b/aspnetcore/release-notes/aspnetcore-11/includes/http-query-openapi.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/http-query-openapi-preview4.md rename to aspnetcore/release-notes/aspnetcore-11/includes/http-query-openapi.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/http3-early-request-processing-preview-3.md b/aspnetcore/release-notes/aspnetcore-11/includes/http3-early-request-processing.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/http3-early-request-processing-preview-3.md rename to aspnetcore/release-notes/aspnetcore-11/includes/http3-early-request-processing.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/infer-passkey-display-name-preview2.md b/aspnetcore/release-notes/aspnetcore-11/includes/infer-passkey-display-name.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/infer-passkey-display-name-preview2.md rename to aspnetcore/release-notes/aspnetcore-11/includes/infer-passkey-display-name.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/kestrel-trailer-header-timeouts-preview-5.md b/aspnetcore/release-notes/aspnetcore-11/includes/kestrel-trailer-header-timeouts.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/kestrel-trailer-header-timeouts-preview-5.md rename to aspnetcore/release-notes/aspnetcore-11/includes/kestrel-trailer-header-timeouts.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/mcp-server-template-preview4.md b/aspnetcore/release-notes/aspnetcore-11/includes/mcp-server-template.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/mcp-server-template-preview4.md rename to aspnetcore/release-notes/aspnetcore-11/includes/mcp-server-template.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/native-otel-tracing-preview2.md b/aspnetcore/release-notes/aspnetcore-11/includes/native-otel-tracing.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/native-otel-tracing-preview2.md rename to aspnetcore/release-notes/aspnetcore-11/includes/native-otel-tracing.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/openapi-3-2-default-preview-6.md b/aspnetcore/release-notes/aspnetcore-11/includes/openapi-3-2-default.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/openapi-3-2-default-preview-6.md rename to aspnetcore/release-notes/aspnetcore-11/includes/openapi-3-2-default.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/openapi-3-2-support-preview2.md b/aspnetcore/release-notes/aspnetcore-11/includes/openapi-3-2-support.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/openapi-3-2-support-preview2.md rename to aspnetcore/release-notes/aspnetcore-11/includes/openapi-3-2-support.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/openapi-schema-improvements-preview-5.md b/aspnetcore/release-notes/aspnetcore-11/includes/openapi-schema-improvements.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/openapi-schema-improvements-preview-5.md rename to aspnetcore/release-notes/aspnetcore-11/includes/openapi-schema-improvements.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/openapi-server-sent-events-preview-7.md b/aspnetcore/release-notes/aspnetcore-11/includes/openapi-server-sent-events.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/openapi-server-sent-events-preview-7.md rename to aspnetcore/release-notes/aspnetcore-11/includes/openapi-server-sent-events.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/performance-improvements-preview2.md b/aspnetcore/release-notes/aspnetcore-11/includes/performance-improvements.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/performance-improvements-preview2.md rename to aspnetcore/release-notes/aspnetcore-11/includes/performance-improvements.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/rate-limiting-retry-after-preview-4.md b/aspnetcore/release-notes/aspnetcore-11/includes/rate-limiting-retry-after.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/rate-limiting-retry-after-preview-4.md rename to aspnetcore/release-notes/aspnetcore-11/includes/rate-limiting-retry-after.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/response-compression-vary-header-preview4.md b/aspnetcore/release-notes/aspnetcore-11/includes/response-compression-vary-header.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/response-compression-vary-header-preview4.md rename to aspnetcore/release-notes/aspnetcore-11/includes/response-compression-vary-header.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/runtime-async-shared-framework-preview4.md b/aspnetcore/release-notes/aspnetcore-11/includes/runtime-async-shared-framework.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/runtime-async-shared-framework-preview4.md rename to aspnetcore/release-notes/aspnetcore-11/includes/runtime-async-shared-framework.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/short-circuit-endpoints-attribute-preview-6.md b/aspnetcore/release-notes/aspnetcore-11/includes/short-circuit-endpoints-attribute.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/short-circuit-endpoints-attribute-preview-6.md rename to aspnetcore/release-notes/aspnetcore-11/includes/short-circuit-endpoints-attribute.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/signalr-auth-refresh-redirects-preview-7.md b/aspnetcore/release-notes/aspnetcore-11/includes/signalr-auth-refresh-redirects.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/signalr-auth-refresh-redirects-preview-7.md rename to aspnetcore/release-notes/aspnetcore-11/includes/signalr-auth-refresh-redirects.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/signalr-authentication-refresh-preview-6.md b/aspnetcore/release-notes/aspnetcore-11/includes/signalr-authentication-refresh.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/signalr-authentication-refresh-preview-6.md rename to aspnetcore/release-notes/aspnetcore-11/includes/signalr-authentication-refresh.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/signalr-cancel-hub-invocations-preview-6.md b/aspnetcore/release-notes/aspnetcore-11/includes/signalr-cancel-hub-invocations.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/signalr-cancel-hub-invocations-preview-6.md rename to aspnetcore/release-notes/aspnetcore-11/includes/signalr-cancel-hub-invocations.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/tls-channel-binding-token-preview-7.md b/aspnetcore/release-notes/aspnetcore-11/includes/tls-channel-binding-token.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/tls-channel-binding-token-preview-7.md rename to aspnetcore/release-notes/aspnetcore-11/includes/tls-channel-binding-token.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/tls-handshake-observability-preview4.md b/aspnetcore/release-notes/aspnetcore-11/includes/tls-handshake-observability.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/tls-handshake-observability-preview4.md rename to aspnetcore/release-notes/aspnetcore-11/includes/tls-handshake-observability.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/user-jwts-file-based-apps-preview-6.md b/aspnetcore/release-notes/aspnetcore-11/includes/user-jwts-file-based-apps.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/user-jwts-file-based-apps-preview-6.md rename to aspnetcore/release-notes/aspnetcore-11/includes/user-jwts-file-based-apps.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/validation-attributes-no-longer-experimental-preview-7.md b/aspnetcore/release-notes/aspnetcore-11/includes/validation-attributes-no-longer-experimental.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/validation-attributes-no-longer-experimental-preview-7.md rename to aspnetcore/release-notes/aspnetcore-11/includes/validation-attributes-no-longer-experimental.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/validation-localization-preview-7.md b/aspnetcore/release-notes/aspnetcore-11/includes/validation-localization.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/validation-localization-preview-7.md rename to aspnetcore/release-notes/aspnetcore-11/includes/validation-localization.md diff --git a/aspnetcore/release-notes/aspnetcore-11/includes/zstandard-compression-preview-3.md b/aspnetcore/release-notes/aspnetcore-11/includes/zstandard-compression.md similarity index 100% rename from aspnetcore/release-notes/aspnetcore-11/includes/zstandard-compression-preview-3.md rename to aspnetcore/release-notes/aspnetcore-11/includes/zstandard-compression.md