Skip to content

Clarify migration analyzer diagnostics are info-level, not visible in build output#4800

Merged
thomhurst merged 2 commits intomainfrom
copilot/clarify-xunit-migration-docs
Feb 14, 2026
Merged

Clarify migration analyzer diagnostics are info-level, not visible in build output#4800
thomhurst merged 2 commits intomainfrom
copilot/clarify-xunit-migration-docs

Conversation

Copy link
Contributor

Copilot AI commented Feb 14, 2026

Migration documentation incorrectly stated that TUXU0001/TUNU0001/TUMS0001 diagnostics would appear as warnings in dotnet build output. These are info-level diagnostics and are not visible without explicit flags.

Changes

  • Removed misleading statement about seeing diagnostics in build output from Step 3 of all migration guides
  • Added optional verification step with command to check analyzer is working before applying changes:
    dotnet format analyzers --severity info --diagnostics TUXU0001 --verify-no-changes
  • Applied consistently across xUnit, NUnit, and MSTest migration documentation

Users can now verify analyzer detection without confusion about why diagnostics don't appear in standard build output.

Original prompt

This section details on the original issue you should resolve

<issue_title>Clarify xUnit migration docs</issue_title>
<issue_description>### Problem Statement

Step 3 of the xUnit migration docs states "You should see TUXU0001 warnings in your build output for xUnit code that can be converted.". But TUXU0001 is information level and won't be in the output of dotnet build, so this step leads to confusion that the analyzer isn't working, even though it is working.

Proposed Solution

Remove this step and skip straight to applying changes, or explain that the analyzer outputs can be viewed without being applied with dotnet format analyzers --severity info --diagnostics TUXU0001 --verify-no-changes

Alternatives Considered

No response

Feature Category

Documentation

How important is this feature to you?

Nice to have - would improve my experience

Additional Context

No response

Contribution

  • I'm willing to submit a pull request for this feature</issue_description>

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


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

…ild output

Co-authored-by: thomhurst <30480171+thomhurst@users.noreply.github.com>
Copilot AI changed the title [WIP] Clarify xUnit migration documentation regarding TUXU0001 warnings Clarify migration analyzer diagnostics are info-level, not visible in build output Feb 14, 2026
Copilot AI requested a review from thomhurst February 14, 2026 20:15
@thomhurst thomhurst marked this pull request as ready for review February 14, 2026 20:29
@thomhurst thomhurst merged commit 01f69f7 into main Feb 14, 2026
6 checks passed
@thomhurst thomhurst deleted the copilot/clarify-xunit-migration-docs branch February 14, 2026 20:29
This was referenced Feb 16, 2026
This was referenced Feb 16, 2026
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.

Clarify xUnit migration docs

2 participants