Skip to content

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

Description

@wadepickett

Description

  1. Remove preview versioning from the include file names for the aspnetcore-11 includes here: aspnetcore/release-notes/aspnetcore-11/includes.

"Preview-" + the following number should be removed from the file name.
Also version-like numbers that belong to the feature name are to remain untouched (http3-early-request-processing, openapi-3-2-default, openapi-3-2-support).

For example:
/aspnetcore-11/includes/async-validation-minimal-apis-preview-6.md

should become:
/aspnetcore-11/includes/async-validation-minimal-apis.md

  1. Update the /aspnetcore/release-notes/aspnetcore-11.md file so that the links to include files are updated to match the new include file names.

Why:
They cause some confusion when the same feature needs to be updated for a later release. They are not needed.

  1. Update the copilot skill: .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.

Example:
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

Page URL

https://learn.microsoft.com/en-us/aspnet/core/release-notes/aspnetcore-11?view=aspnetcore-10.0&tabs=minimal-apis

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/release-notes/aspnetcore-11.md

Document ID

5f749050-bd63-c782-f5a6-834dbaa7a1bc

Platform Id

e8eaff50-8e78-f831-b4d1-c5309fcb547e

Article author

@wadepickett

Metadata

  • ID: 5f749050-bd63-c782-f5a6-834dbaa7a1bc
  • PlatformId: e8eaff50-8e78-f831-b4d1-c5309fcb547e
  • Service: aspnet-core
  • Sub-service: release-notes

Related Issues


Associated WorkItem - 631440

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions