Skip to content

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Oct 20, 2025

Freshness Pass for .NET Fundamentals Documentation - July

This PR updates 39 high-traffic documentation articles to ensure content accuracy and freshness.

Task Checklist

  • Review and update /dotnet/core/extensions/windows-service.md
  • Review and update /dotnet/core/testing/unit-testing-code-coverage.md
  • Review and update /dotnet/core/extensions/channels.md
  • Review and update /dotnet/standard/assembly/index.md
  • Review and update /dotnet/standard/parallel-programming/task-based-asynchronous-programming.md
  • Review and update /dotnet/standard/collections/thread-safe/index.md
  • Review and update /dotnet/core/resilience/http-resilience.md (removed version pinning)
  • Review and update /dotnet/core/extensions/caching.md
  • Review and update /dotnet/core/testing/unit-testing-csharp-with-nunit.md
  • Review and update /dotnet/core/testing/index.md
  • Review and update /dotnet/fundamentals/networking/sockets/socket-services.md
  • Review and update /dotnet/core/extensions/logging-providers.md
  • Review and update /dotnet/standard/parallel-programming/task-parallel-library-tpl.md
  • Review and update /dotnet/core/extensions/high-performance-logging.md
  • Review and update /dotnet/standard/collections/index.md
  • Review and update /dotnet/fundamentals/networking/sockets/tcp-classes.md
  • Review and update /dotnet/core/extensions/queue-service.md
  • Review and update /dotnet/core/extensions/logger-message-generator.md
  • Review and update /dotnet/core/extensions/create-resource-files.md
  • Review and update /dotnet/standard/base-types/regular-expression-source-generators.md
  • Review and update /dotnet/standard/parallel-programming/dataflow-task-parallel-library.md
  • Review and update /dotnet/core/resilience/index.md (removed version pinning)
  • Review and update /dotnet/standard/parallel-programming/index.md
  • Review and update /dotnet/core/extensions/custom-logging-provider.md
  • Review and update /dotnet/core/extensions/console-log-formatter.md
  • Review and update /dotnet/standard/events/observer-design-pattern.md
  • Review and update /dotnet/core/extensions/windows-service-with-installer.md
  • Review and update /dotnet/core/extensions/work-with-resx-files-programmatically.md
  • Review and update /dotnet/standard/garbage-collection/implementing-disposeasync.md
  • Review and update /dotnet/standard/parallel-programming/task-cancellation.md
  • Review and update /dotnet/core/docker/introduction.md
  • Review and update /dotnet/standard/parallel-programming/chaining-tasks-by-using-continuation-tasks.md
  • Review and update /dotnet/core/extensions/timer-service.md
  • Review and update /dotnet/core/extensions/localization.md
  • Review and update /dotnet/core/extensions/custom-configuration-provider.md
  • Review and update /dotnet/standard/events/how-to-raise-and-consume-events.md
  • Review and update /dotnet/standard/assembly/sign-strong-name.md
  • Review and update /dotnet/core/extensions/service-discovery.md (removed prerelease flag)
  • Review and update /dotnet/standard/assembly/strong-named.md

Review Process

For each article:

  1. Cross-referenced APIs with dotnet/runtime and dotnet/extensions repositories
  2. Verified content accuracy
  3. Updated ms.date to 10/20/2025 once reviewed

Changes Summary

  • Updated ms.date to 10/20/2025 for all 39 articles
  • Removed version pinning from Microsoft.Extensions.Http.Resilience package references
  • Removed version pinning from Microsoft.Extensions.Resilience package references
  • Removed --prerelease flag from Microsoft.Extensions.ServiceDiscovery package installation (now stable)
  • Restored .NET 10+ SDK command alternative in service-discovery.md
Original prompt

This section details on the original issue you should resolve

<issue_title>DotNet Fundamentals - Freshness Opportunities - July</issue_title>
<issue_description>### Describe the issue or suggestion

The following topics are above 1k page views and should be reviewed for freshness, and updated, if needed:

/dotnet/core/extensions/windows-service.md
/dotnet/core/testing/unit-testing-code-coverage.md
/dotnet/core/extensions/channels.md
/dotnet/standard/assembly/index.md
/dotnet/standard/parallel-programming/task-based-asynchronous-programming.md
/dotnet/standard/collections/thread-safe/index.md
/dotnet/core/resilience/http-resilience.md
/dotnet/core/extensions/caching.md
/dotnet/core/testing/unit-testing-csharp-with-nunit.md
/dotnet/core/testing/index.md
/dotnet/fundamentals/networking/sockets/socket-services.md
/dotnet/core/extensions/logging-providers.md
/dotnet/standard/parallel-programming/task-parallel-library-tpl.md
/dotnet/core/extensions/high-performance-logging.md
/dotnet/standard/collections/index.md
/dotnet/fundamentals/networking/sockets/tcp-classes.md
/dotnet/core/extensions/queue-service.md
/dotnet/core/extensions/logger-message-generator.md
/dotnet/core/extensions/create-resource-files.md
/dotnet/standard/base-types/regular-expression-source-generators.md
/dotnet/standard/parallel-programming/dataflow-task-parallel-library.md
/dotnet/core/resilience/index.md
/dotnet/standard/parallel-programming/index.md
/dotnet/core/extensions/custom-logging-provider.md
/dotnet/core/extensions/console-log-formatter.md
/dotnet/standard/events/observer-design-pattern.md
/dotnet/core/extensions/windows-service-with-installer.md
/dotnet/core/extensions/work-with-resx-files-programmatically.md
/dotnet/standard/garbage-collection/implementing-disposeasync.md
/dotnet/standard/parallel-programming/task-cancellation.md
/dotnet/core/docker/introduction.md
/dotnet/standard/parallel-programming/chaining-tasks-by-using-continuation-tasks.md
/dotnet/core/extensions/timer-service.md
/dotnet/core/extensions/localization.md
/dotnet/core/extensions/custom-configuration-provider.md
/dotnet/standard/events/how-to-raise-and-consume-events.md
/dotnet/standard/assembly/sign-strong-name.md
/dotnet/core/extensions/service-discovery.md
/dotnet/standard/assembly/strong-named.md</issue_description>

<agent_instructions>Please work through this freshness pass, by evaluating each article in the issue description. The source of truth is both the https://github.com/dotnet/runtime and the https://github.com/dotnet/extensions repos. Whenever you read an article, look at APIs being discussed and do a cross-reference lookup to either repo. If the content is accurate, please update the ms.date to 10/20/2025. If the content needs updates, apply updates needed and then update the ms.date.</agent_instructions>

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

Fixes #47440


✨ 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

Toggle expand/collapse
📄 File 🔗 Preview link
docs/core/docker/introduction.md docs/core/docker/introduction
docs/core/extensions/caching.md docs/core/extensions/caching
docs/core/extensions/channels.md docs/core/extensions/channels
docs/core/extensions/console-log-formatter.md docs/core/extensions/console-log-formatter
docs/core/extensions/create-resource-files.md docs/core/extensions/create-resource-files
docs/core/extensions/custom-configuration-provider.md docs/core/extensions/custom-configuration-provider
docs/core/extensions/custom-logging-provider.md docs/core/extensions/custom-logging-provider
docs/core/extensions/high-performance-logging.md docs/core/extensions/high-performance-logging
docs/core/extensions/localization.md docs/core/extensions/localization
docs/core/extensions/logger-message-generator.md docs/core/extensions/logger-message-generator
docs/core/extensions/logging-providers.md docs/core/extensions/logging-providers
docs/core/extensions/queue-service.md docs/core/extensions/queue-service
docs/core/extensions/service-discovery.md docs/core/extensions/service-discovery
docs/core/extensions/timer-service.md docs/core/extensions/timer-service
docs/core/extensions/windows-service-with-installer.md docs/core/extensions/windows-service-with-installer
docs/core/extensions/windows-service.md docs/core/extensions/windows-service
docs/core/extensions/work-with-resx-files-programmatically.md docs/core/extensions/work-with-resx-files-programmatically
docs/core/resilience/http-resilience.md docs/core/resilience/http-resilience
docs/core/resilience/index.md docs/core/resilience/index
docs/core/testing/index.md docs/core/testing/index
docs/core/testing/unit-testing-code-coverage.md docs/core/testing/unit-testing-code-coverage
docs/core/testing/unit-testing-csharp-with-nunit.md docs/core/testing/unit-testing-csharp-with-nunit
docs/fundamentals/networking/sockets/socket-services.md docs/fundamentals/networking/sockets/socket-services
docs/fundamentals/networking/sockets/tcp-classes.md docs/fundamentals/networking/sockets/tcp-classes
docs/standard/assembly/index.md docs/standard/assembly/index
docs/standard/assembly/sign-strong-name.md docs/standard/assembly/sign-strong-name
docs/standard/assembly/strong-named.md docs/standard/assembly/strong-named
docs/standard/base-types/regular-expression-source-generators.md docs/standard/base-types/regular-expression-source-generators
docs/standard/collections/index.md docs/standard/collections/index
docs/standard/collections/thread-safe/index.md docs/standard/collections/thread-safe/index

Note

This table shows preview links for the 30 files with the most changes. For preview links for other files in this PR, select OpenPublishing.Build Details within checks.

@Copilot Copilot AI changed the title [WIP] Update DotNet documentation for freshness opportunities Update freshness dates and package references for 39 high-traffic .NET documentation articles Oct 20, 2025
@Copilot Copilot AI requested a review from IEvangelist October 20, 2025 15:48
Copilot finished work on behalf of IEvangelist October 20, 2025 15:48
@IEvangelist IEvangelist marked this pull request as ready for review October 20, 2025 18:15
@IEvangelist IEvangelist requested review from a team, adegeo and gewarren as code owners October 20, 2025 18:15
@Copilot Copilot AI review requested due to automatic review settings October 20, 2025 18:15
@IEvangelist IEvangelist enabled auto-merge (squash) October 20, 2025 18:15
Copy link
Contributor

@Copilot 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 freshness dates for 39 high-traffic .NET documentation articles to 10/20/2025 after verification of content accuracy. The PR also modernizes package installation instructions by removing unnecessary version pinning from resilience packages and removing the --prerelease flag from service discovery package installation now that it's stable.

  • Updated ms.date metadata to 10/20/2025 across all articles
  • Removed version numbers from Microsoft.Extensions.Resilience and Microsoft.Extensions.Http.Resilience package references
  • Removed --prerelease flag from Microsoft.Extensions.ServiceDiscovery installation instructions

Reviewed Changes

Copilot reviewed 39 out of 39 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
docs/standard/parallel-programming/*.md (5 files) Date updates for parallel programming articles
docs/standard/garbage-collection/implementing-disposeasync.md Date update for DisposeAsync implementation guide
docs/standard/events/*.md (2 files) Date updates for event pattern articles
docs/standard/collections/*.md (2 files) Date updates for collections documentation
docs/standard/base-types/regular-expression-source-generators.md Date update for regex source generators
docs/standard/assembly/*.md (3 files) Date updates for assembly documentation
docs/fundamentals/networking/sockets/*.md (2 files) Date updates for socket programming articles
docs/core/testing/*.md (3 files) Date updates for testing documentation
docs/core/resilience/*.md (2 files) Date updates and removed version pinning from resilience package references
docs/core/extensions/*.md (17 files) Date updates across extension articles; removed --prerelease flag from service discovery
docs/core/docker/introduction.md Date update for Docker introduction

Comment on lines +21 to 23
dotnet add package Microsoft.Extensions.ServiceDiscovery
```

Copy link

Copilot AI Oct 20, 2025

Choose a reason for hiding this comment

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

The removal of the --prerelease flag assumes the package is now stable at version 9.5.1. However, without explicit verification that this version exists and is stable, the documentation could mislead users. Consider adding a note about the minimum stable version or verifying the package status.

Suggested change
dotnet add package Microsoft.Extensions.ServiceDiscovery
```
dotnet add package Microsoft.Extensions.ServiceDiscovery --version 9.5.1

Note

The Microsoft.Extensions.ServiceDiscovery package is stable starting from version 9.5.1. Make sure to use at least this version or newer to avoid prerelease issues.

Copilot uses AI. Check for mistakes.

Copy link
Contributor

@meaghanlewis meaghanlewis left a comment

Choose a reason for hiding this comment

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

LGTM other than one comment about removed lines.

auto-merge was automatically disabled October 21, 2025 01:54

Head branch was pushed to by a user without write access

@Copilot Copilot AI requested a review from IEvangelist October 21, 2025 01:54
Copilot finished work on behalf of IEvangelist October 21, 2025 01:54
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.

DotNet Fundamentals - Freshness Opportunities - July

3 participants