Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Dec 4, 2025

Fixes #36376

Description

The Kestrel overview page previously showed enhanced feature listing only for .NET 10. This PR extends that feature list to .NET 8 and later, while moving memory pool content to a dedicated article as requested by the maintainer.

Changes

  • New article: Created memory-management.md under Kestrel section (moniker: >= aspnetcore-10.0)

    • Covers automatic memory pool eviction (new in .NET 10)
    • Documents IMemoryPoolFactory usage and custom implementations
  • Kestrel overview: Split into two moniker ranges

    • .NET 10+: Full feature list including memory management with link to new article
    • .NET 8-9: Same feature list excluding memory management (not available in these versions)
  • Removed sections:

    • "Optional client certificates" from main overview and kestrel6.md include
    • Inline memory eviction content (now in dedicated article)
  • TOC: Added memory management article after Diagnostics

Moniker Strategy

:::moniker range=">= aspnetcore-10.0"
<!-- Full feature list with memory management -->
:::moniker-end

:::moniker range=">= aspnetcore-8.0 < aspnetcore-10.0"
<!-- Feature list without memory management -->
:::moniker-end

This ensures version-specific features appear only for supported versions while maintaining the enhanced overview for all .NET 8+ users.

Original prompt

This section details on the original issue you should resolve

<issue_title>Show updated Kestrel overview content for .NET 8 and later</issue_title>
<issue_description>### Description

Currently the Kestrel overview page shows a nice listing of Kestrel's features, but only for .NET 10. An older version of the Kestrel overview page is shown for all prior .NET versions. We should update the update the Kestrel overview page to show the full feature list for .NET 8 and later.

Page URL

https://learn.microsoft.com/en-us/aspnet/core/fundamentals/servers/kestrel?view=aspnetcore-9.0

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/fundamentals/servers/kestrel.md

Document ID

3e0e12c2-e544-5655-e001-d2ec180b11a8

Platform Id

1464e7f0-899a-541e-4b11-134d7f16a7be

Article author

@tdykstra

Metadata

  • ID: f22dcddb-0c25-be1a-9a02-9e71dce86bdb
  • PlatformId: 1464e7f0-899a-541e-4b11-134d7f16a7be
  • Service: aspnet-core
  • Sub-service: fundamentals

Related Issues

@JamesNK </issue_description>

Comments on the Issue (you are @copilot in this section)

@JamesNK Other things to do when looking at this page:
  • Move details about memory pool somewhere else. It shouldn't be on the Kestrel overview page. I think add a new page to Kestrel section and call it "Memory management"
  • Remove "Optional client certificates" section. I don't know why it's here</comment_new>

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.


Internal previews

📄 File 🔗 Preview link
aspnetcore/fundamentals/servers/kestrel.md aspnetcore/fundamentals/servers/kestrel
aspnetcore/fundamentals/servers/kestrel/memory-management.md aspnetcore/fundamentals/servers/kestrel/memory-management
aspnetcore/toc.yml aspnetcore/toc

Copilot AI changed the title [WIP] Update Kestrel overview content for .NET 8 and later Show Kestrel overview feature list for .NET 8+ and move memory management to dedicated article Dec 4, 2025
Copilot AI requested a review from tdykstra December 4, 2025 23:31
Copilot finished work on behalf of tdykstra December 4, 2025 23:31
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.

Show updated Kestrel overview content for .NET 8 and later

2 participants