Skip to content

Add xref links to new .NET 11 Preview 2 APIs in what's-new docs#52323

Merged
gewarren merged 4 commits intomainfrom
copilot/link-preview-2-apis
Mar 17, 2026
Merged

Add xref links to new .NET 11 Preview 2 APIs in what's-new docs#52323
gewarren merged 4 commits intomainfrom
copilot/link-preview-2-apis

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Mar 16, 2026

New .NET 11 APIs introduced in Preview 2 were referenced as plain backtick text in libraries.md instead of xref links. Updates three locations:

  • ZipCompressionMethod enum members: Stored, Deflate, and Deflate64 now link to System.IO.Compression.ZipCompressionMethod.*
  • StringSyntaxAttribute language constants: CSharp, FSharp, and VisualBasic now link to System.Diagnostics.CodeAnalysis.StringSyntaxAttribute.* with nameWithType
  • JsonSerializerOptions generic methods: Inline text for GetTypeInfo<T> and TryGetTypeInfo<T>() now use full xrefs with generic type parameter encoding:
    <xref:System.Text.Json.JsonSerializerOptions.GetTypeInfo``1?displayProperty=nameWithType>
    <xref:System.Text.Json.JsonSerializerOptions.TryGetTypeInfo``1(System.Text.Json.Serialization.Metadata.JsonTypeInfo{``0}@)?displayProperty=nameWithType>
    

Note: SVE2 intrinsics (ShiftRightLogicalNarrowingSaturate) mentioned in runtime.md are not yet published to dotnet/dotnet-api-docs and remain unlinked.


Internal previews

📄 File 🔗 Preview link
docs/core/whats-new/dotnet-11/libraries.md What's new in .NET libraries for .NET 11

Copilot AI and others added 2 commits March 13, 2026 21:00
Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Comment thread docs/core/whats-new/dotnet-11/libraries.md Outdated
Comment thread docs/core/whats-new/dotnet-11/libraries.md
@gewarren gewarren marked this pull request as ready for review March 16, 2026 18:30
@gewarren gewarren requested a review from a team as a code owner March 16, 2026 18:30
Copilot AI review requested due to automatic review settings March 16, 2026 18:30
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR updates the .NET 11 “what’s new” libraries documentation to replace inline backticked API names with <xref:...> links so readers can navigate directly to the relevant API reference entries.

Changes:

  • Link ZipCompressionMethod enum members (Stored, Deflate, and Deflate64) via xrefs.
  • Link StringSyntaxAttribute language constants (CSharp, FSharp, and VisualBasic) via xrefs.
  • Link JsonSerializerOptions generic metadata methods (GetTypeInfo<T> and TryGetTypeInfo<T>) via xrefs.

You can also share your feedback on Copilot code review. Take the survey.

Comment thread docs/core/whats-new/dotnet-11/libraries.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Copy link
Copy Markdown
Member

@BillWagner BillWagner left a comment

Choose a reason for hiding this comment

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

This LGTM. Let's :shipit:

@gewarren gewarren merged commit 938e7f8 into main Mar 17, 2026
11 checks passed
@gewarren gewarren deleted the copilot/link-preview-2-apis branch March 17, 2026 19:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants