Skip to content

What's New: Remove preview version suffixes from .NET 11 include filenames - #37596

Merged
wadepickett merged 4 commits into
mainfrom
copilot/remove-preview-versioning
Sep 5, 2026
Merged

What's New: Remove preview version suffixes from .NET 11 include filenames#37596
wadepickett merged 4 commits into
mainfrom
copilot/remove-preview-versioning

Conversation

Copilot AI commented Sep 5, 2026

Copy link
Copy Markdown
Contributor

Reviewers:
I'm hoping to get this PR in quickly to clean up the What's New include file names before I add some more updates in a following PR based on up to date release notes.

Preview version suffixes (-preview-N / -previewN) on the What's New in .NET 11 include filenames add churn when a feature is updated for a later preview, and serve no purpose. This drops the suffixes and updates the references.

Changes

  • Renamed 29 includes in aspnetcore/release-notes/aspnetcore-11/includes/ via git mv (history preserved), stripping the trailing preview suffix. Version-like numbers that belong to the feature name are untouched (http3-early-request-processing, openapi-3-2-default, openapi-3-2-support).
  • aspnetcore/release-notes/aspnetcore-11.md: updated all 29 [!INCLUDE[] link paths to match; refreshed ms.date.
  • .github/skills/whats-new-include-content-rules/SKILL.md: the file-naming convention previously required a -preview-{N} suffix (with an enforcing validation-checklist item and performance-file exception). Flipped to forbid it so the automation and contributors don't re-introduce the suffixes. Content-level guidance (no preview numbers in body text) is unchanged.
async-validation-minimal-apis-preview-6.md      -> async-validation-minimal-apis.md
endpoint-filters-binding-failures-preview4.md   -> endpoint-filters-binding-failures.md
openapi-3-2-support-preview2.md                 -> openapi-3-2-support.md

Verification

36 include references map 1:1 to 36 files on disk — no broken links, no orphaned includes, no remaining preview-suffixed filenames.

Note on scope

The issue asks only for the rename + link updates. The skill edit is included because that rule is the root cause that would regenerate the suffixes on the next preview; it's isolated to one file and can be dropped independently if you'd prefer to handle the guidance change separately.


Internal previews

Toggle expand/collapse
File Preview link
aspnetcore/release-notes/aspnetcore-11.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/async-validation-minimal-apis.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/consistent-authorization-metadata.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/csharp-unions.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/endpoint-filters-binding-failures.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/file-result-openapi.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/http-query-openapi.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/http3-early-request-processing.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/infer-passkey-display-name.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/kestrel-trailer-header-timeouts.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/mcp-server-template.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/native-otel-tracing.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/openapi-3-2-default.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/openapi-3-2-support.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/openapi-schema-improvements.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/openapi-server-sent-events.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/performance-improvements.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/rate-limiting-retry-after.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/response-compression-vary-header.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/runtime-async-shared-framework.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/short-circuit-endpoints-attribute.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/signalr-auth-refresh-redirects.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/signalr-authentication-refresh.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/signalr-cancel-hub-invocations.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/tls-channel-binding-token.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/tls-handshake-observability.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/user-jwts-file-based-apps.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/validation-attributes-no-longer-experimental.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/validation-localization.md Learn preview
aspnetcore/release-notes/aspnetcore-11/includes/zstandard-compression.md Learn preview

Build report

Copilot AI and others added 2 commits September 5, 2026 00:51
…pdate links

Co-authored-by: wadepickett <10985336+wadepickett@users.noreply.github.com>
Co-authored-by: wadepickett <10985336+wadepickett@users.noreply.github.com>
Copilot AI changed the title [WIP] Remove preview versioning from include file names and update links What's New: Remove preview version suffixes from .NET 11 include filenames Sep 5, 2026
Copilot AI requested a review from wadepickett September 5, 2026 00:57
Comment thread aspnetcore/release-notes/aspnetcore-11.md Outdated

@guardrex guardrex left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice one! 🎉

@wadepickett
wadepickett marked this pull request as ready for review September 5, 2026 21:22
@wadepickett
wadepickett merged commit c8ab8d7 into main Sep 5, 2026
5 checks passed
@wadepickett
wadepickett deleted the copilot/remove-preview-versioning branch September 5, 2026 21:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

What's New: Remove preview versioning from include file names and update agent skill

3 participants