Repository navigation
V5.2.3/service update - #38
Conversation
[Medium impact] The changes reach shared project dependencies, documentation publishing, and release automation. The PR still needs the version check fixed before merging because dependency updates can fail before the release is tagged.
|
Test, benchmark, and XML documentation guidance now lives in AGENTS.md so agents read one source of truth. The separate copilot-instructions file is retired and references point to AGENTS.md.
The DocFX image now uses DHI nginx and copies a dedicated nginx configuration. Fingerprinted DocFX assets are cached immutably, while pages and navigation data keep stable URLs without stale validators.
API members now render on separate pages, the Microsoft-style template is included, and a monthly sitemap is generated for the published site.
The service update workflow now reads the latest stable Git tag instead of the changelog heading. It reuses a pending TBD release and updates an existing matching changelog section rather than duplicating it.
Shared test projects now use Codebelt.Coverlet.MTP and Microsoft.Testing.Extensions.HangDump instead of the CodeCoverage package. Test SDK, xUnit, and .NET 9 and 10 framework baselines move to their latest stable releases.
The per-project test loop passes the test project through the --project option so each project runs on its own.
The 5.2.3 changelog entry now lists the dependency, DocFX hosting, and contributor guidance changes that shipped in this service update, and the Unreleased section is folded into the versioned release.
| if current_version == next_version and current_status.upper() == "TBD": | ||
| # Reuse an already pending next release, such as [5.0.13] - TBD. | ||
| new_version = next_version | ||
| elif current_version == latest_version and current_status.upper() != "TBD": |
There was a problem hiding this comment.
Updates fail before release tagging
If another dependency update runs after this PR merges but before v5.2.3 is tagged, the dated 5.2.3 heading fails both allowed branches. The workflow exits before updating packages or opening a PR. Its own changelog writer creates this dated-but-untagged state.
Allow the pending next version with a date too, or keep it marked TBD until release.
Prompt To Fix With AI
This is a comment left during a code review.
Path: .github/workflows/service-update.yml
Line: 86-89
Comment:
**Updates fail before release tagging**
If another dependency update runs after this PR merges but before `v5.2.3` is tagged, the dated `5.2.3` heading fails both allowed branches. The workflow exits before updating packages or opening a PR. Its own changelog writer creates this dated-but-untagged state.
Allow the pending next version with a date too, or keep it marked `TBD` until release.
---
For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.Missing fingerprinted DocFX assets were returned with the immutable one-year cache policy, so clients could keep a 404 cached for a year. Route those misses through a no-store error location and keep the immutable policy only for successful responses.
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## main #38 +/- ##
=========================================
Coverage 100.00% 100.00%
=========================================
Files 22 22
Lines 308 300 -8
Branches 29 24 -5
=========================================
- Hits 308 300 -8 ☔ View full report in Codecov by Harness. 🚀 New features to boost your workflow:
|
|
|
You are seeing this message because GitHub Code Scanning has recently been set up for this repository, or this pull request contains the workflow file for the Code Scanning tool. What Enabling Code Scanning Means:
For more information about GitHub Code Scanning, check out the documentation. |



This is a service update that focuses on package dependencies.
Automated changes:
Note: Third-party packages (Microsoft.Extensions.*, BenchmarkDotNet, etc.) are not auto-updated.
Use Dependabot or manual updates for those.
Generated by codebelt-aicia
Triggered by: swashbuckle-aspnetcore @ 10.3.0