[EduardF1]

Summary

Surfaces information about OpenAPI build-time document generation visibility in the NuGet PACKAGE.md, addressing the issue where the new .NET 8 Terminal Logger suppresses the generation tool output by default.

Problem

When running dotnet build with the Terminal Logger (the default in .NET 8+), the Microsoft.Extensions.ApiDescription.Server GetDocument tool output is suppressed. Users see no indication that document generation ran, making it difficult to debug generation issues.

Solution

Documents the available workarounds in the package README:

• Use -tlp:v=d for detailed Terminal Logger verbosity to see generation output
• Use --tl:off to disable the Terminal Logger and fall back to classic logging

This approach is noted in the issue as an acceptable solution while the upstream MSBuild/SDK changes (dotnet/msbuild#9810, dotnet/sdk#43293) are tracked.

Changes

• src/OpenApi/src/PACKAGE.md: Added a new section "Build-time Document Generation" documenting the Terminal Logger verbosity options

Fixes #62273

[dotnet-policy-service]

Thanks for your PR, @EduardF1. Someone from the team will get assigned to your PR shortly and we'll get it reviewed.

[EduardF1]

Thanks for the acknowledgment. Happy to adjust the PACKAGE.md wording or add any extra doc context if that would help once someone from the team takes a look.

[mikekistler]

Looks good. 👍

I've hit this issue before and didn't realize the underlying cause was the Terminal Logger. I'm sure this information will be helpful to some users.

[EduardF1]

CI is green here and there are no requested changes. Ready to merge whenever convenient. Thanks @mikekistler for the review.

[EduardF1]

Hi! This PR has been approved — could you merge it when convenient? Thanks!

[EduardF1]

Friendly ping — could someone from the team merge this?

[EduardF1]

Hi! This was approved — could you merge when you get a chance? Happy to rebase if needed. Thanks!

[EduardF1]

Friendly ping — could someone from the team merge this?

[EduardF1]

Thanks for the review, @mikekistler!

This one now looks ready on the contributor side — all checks are green and it's a docs-only change to src/OpenApi/src/PACKAGE.md addressing the help wanted / good first issue #62273.

The only thing outstanding is the needs-area-label triage. The linked issue is labeled area-commandlinetools and feature-openapi — could a maintainer apply the area label here so it can be routed for final review/merge? Happy to make any adjustments if needed.