Skip to content

Document new dotnet test MTP command-line options#51458

Merged
meaghanlewis merged 4 commits intomainfrom
copilot/revise-cli-documentation
Feb 4, 2026
Merged

Document new dotnet test MTP command-line options#51458
meaghanlewis merged 4 commits intomainfrom
copilot/revise-cli-documentation

Conversation

Copy link
Contributor

Copilot AI commented Feb 3, 2026

SDK added four new command-line options for dotnet test with Microsoft.Testing.Platform that were undocumented.

Changes

  • Added option documentation:

    • --config-file: Configuration file path for test execution
    • --results-directory: Test results output directory (auto-created, supports relative paths)
    • --diagnostic-output-directory: Diagnostic output directory (auto-created, supports relative paths)
    • --minimum-expected-tests: Minimum test count enforcement (fails with exit code 9 if unmet)
  • Updated synopsis with new options in correct order

  • Added examples demonstrating new options:

    dotnet test --results-directory ./TestResults
    dotnet test --diagnostic-output-directory ./Diagnostics
    dotnet test --minimum-expected-tests 10

All options note that relative paths are converted to absolute paths based on current directory.

References

Implemented in:

Original prompt

This section details on the original issue you should resolve

<issue_title>dotnet test for Microsoft.Testing.Platform: revise command-line documentation</issue_title>
<issue_description>### Describe the issue or suggestion

As we are progressing, we make changes to the CLI of the new dotnet test implementation in .NET 10.

We need to take a pass to ensure everything is documented correctly. For example, we are adding --minimum-expected-tests in dotnet/sdk#50527, we need to include it in the documentation. There might be some more changes that we made and we forgot to update the doc


Associated WorkItem - 550424</issue_description>

<agent_instructions>Add the following options to: https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-test-mtp. --config-file, --results-directory, --diagnostic-output-directory, --minimum-expected-tests</agent_instructions>

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

@meaghanlewis @Youssef1313 I'm going to work on this.

Should I also add the options that are listed as done in: dotnet/sdk#49709?</comment_new>
<comment_new>@Youssef1313
@meaghanlewis Yes. The options in that issue should be documented, if they are not.</comment_new>


✨ 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

📄 File 🔗 Preview link
docs/core/tools/dotnet-test-mtp.md dotnet test with Microsoft.Testing.Platform (MTP)

Co-authored-by: meaghanlewis <10103121+meaghanlewis@users.noreply.github.com>
Copilot AI changed the title [WIP] Revise command-line documentation for dotnet test Document new dotnet test MTP command-line options Feb 3, 2026
Copilot AI requested a review from meaghanlewis February 3, 2026 23:40
@meaghanlewis meaghanlewis marked this pull request as ready for review February 4, 2026 00:16
@meaghanlewis meaghanlewis requested a review from a team as a code owner February 4, 2026 00:16
Copilot AI review requested due to automatic review settings February 4, 2026 00:16
Copy link
Contributor

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 documents four new command-line options for dotnet test with Microsoft.Testing.Platform that were previously undocumented in the SDK. The changes ensure the .NET 10 SDK documentation reflects the latest CLI capabilities.

Changes:

  • Added documentation for --config-file, --results-directory, --diagnostic-output-directory, and --minimum-expected-tests options
  • Updated the command synopsis to include the new options in logical order
  • Added usage examples demonstrating three of the four new options

@meaghanlewis meaghanlewis merged commit 739d0cd into main Feb 4, 2026
11 checks passed
@meaghanlewis meaghanlewis deleted the copilot/revise-cli-documentation branch February 4, 2026 18:23
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 test for Microsoft.Testing.Platform: revise command-line documentation

5 participants