Skip to content

Document recent dotnet test SDK changes - #55961

Open
Evangelink wants to merge 1 commit into
mainfrom
dev/amauryleve/audit-dotnet-test-docs
Open

Document recent dotnet test SDK changes#55961
Evangelink wants to merge 1 commit into
mainfrom
dev/amauryleve/audit-dotnet-test-docs

Conversation

@Evangelink

@Evangelink Evangelink commented Sep 12, 2026

Copy link
Copy Markdown
Member

The durable dotnet test reference had fallen behind user-visible SDK changes from the past six months, especially for Microsoft.Testing.Platform (MTP). This update aligns the CLI, MTP, and MSTest guidance with shipped behavior and explicitly identifies the SDK or package version required for newer capabilities.

What changed

  • Expand the MTP command reference with version-qualified .NET 10 servicing behavior, .NET 11 options and semantics, and .NET 12 Preview 1 input support.
  • Document runner selection through DOTNET_TEST_RUNNER, mobile and traversal projects, structured test discovery, run-level policies, result layouts, artifacts, output streaming, cancellation, and argument forwarding.
  • Add --no-dependencies to the VSTest reference.
  • Correct the MTP built-module example to use --test-modules.
  • Add direct cross-references among dotnet test, MTP, MSTest, and MSTest.Sdk guidance.
  • Record three open .NET 11 RC 1 regressions as known issues without describing proposed fixes as shipped.

Source breakdown

  • SDK feature and behavior details were adapted from merged and open dotnet/sdk pull requests and issues dated March 12 through September 12, 2026.
  • Existing .NET 11 What's New coverage was retained and extended with the verified RC 1 known issues.
  • Command-reference wording, organization, examples, version qualifiers, and cross-reference text were newly generated and require product-owner review.

Review notes

Please pay particular attention to preview and RC version boundaries, MTP 2.4 requirements, mobile device constraints, and the placement of temporary RC 1 known issues.

Validation

  • npx --yes markdownlint-cli2 passed for all seven changed Markdown files.
  • git diff --check passed.
  • Repository-relative links were checked locally.

Internal previews

File Preview link
docs/core/testing/microsoft-testing-platform-run-and-debug.md Learn preview
docs/core/testing/unit-testing-mstest-running-tests.md Learn preview
docs/core/testing/unit-testing-with-dotnet-test.md Learn preview
docs/core/tools/dotnet-test-mtp.md Learn preview
docs/core/tools/dotnet-test-vstest.md Learn preview
docs/core/tools/dotnet-test.md Learn preview
docs/core/whats-new/dotnet-11/sdk.md Learn preview

Build report

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot review overview

🟡 Changes recommended

The MTP reference has unresolved accuracy and compatibility documentation issues.

Get a fresh assessment by requesting another Copilot review.

Review tier: Lite
Findings: 2 Low severity

Open findings (2)
What changed in this PR

Updates .NET testing documentation for recent SDK, VSTest, MSTest, and Microsoft.Testing.Platform behavior.

Changes:

  • Expands MTP options, device support, artifacts, and runner guidance.
  • Adds VSTest dependency controls and cross-references.
  • Documents .NET 11 RC 1 known issues and corrects examples.
File Description
docs/​core/​whats-new/​dotnet-11/​sdk.md Adds known RC 1 test issues.
docs/​core/​tools/​dotnet-test.md Documents runner selection.
docs/​core/​tools/​dotnet-test-vstest.md Adds --no-dependencies.
docs/​core/​tools/​dotnet-test-mtp.md Expands MTP command guidance.
docs/​core/​testing/​unit-testing-with-dotnet-test.md Documents environment-based runner selection.
docs/​core/​testing/​unit-testing-mstest-running-tests.md Adds MTP and SDK references.
docs/​core/​testing/​microsoft-testing-platform-run-and-debug.md Updates MTP execution examples.

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

> [!NOTE]
> You can use only one of the following options at a time: `--project`, `--solution`, or `--test-modules`. These options can't be combined.
> In addition, when using `--test-modules`, you can't specify `--arch`, `--configuration`, `--framework`, `--os`, or `--runtime`. These options aren't relevant for an already-built module.
> In addition, when you use `--test-modules`, you can't specify `--arch`, `--configuration`, `--framework`, `--os`, `--runtime`, or `--use-current-runtime`. These options aren't relevant for an already-built module.

Stops the complete run after it reaches the specified number of failed, errored, timed-out, or canceled tests. The run exits with code 13.

Available starting with .NET 11 RC 1 and requires MTP 2.4 or later.
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.

2 participants