Open
Conversation
Youssef1313
reviewed
Feb 25, 2026
docs/core/testing/microsoft-testing-platform-troubleshooting.md
Outdated
Show resolved
Hide resolved
Youssef1313
reviewed
Feb 25, 2026
Evangelink
requested review from
a team,
gewarren and
meaghanlewis
as code owners
Contributor
There was a problem hiding this comment.
Pull request overview
This PR refactors the Microsoft.Testing.Platform (MTP) documentation to improve navigation and organization. It shifts from an extension-centric structure to a feature-centric structure, making it easier for users to find the information they need based on their goals rather than navigating through generic "extensions" categories.
Changes:
- Adds new test platforms overview page to help users choose between VSTest and MTP
- Reorganizes MTP documentation from extension categories to feature-specific pages (terminal output, test reports, code coverage, crash/hang dumps, retry, hot reload, fakes, OpenTelemetry, telemetry)
- Creates consolidated CLI options reference page
- Merges exit codes and FAQ content into unified troubleshooting page
- Splits architecture documentation into separate pages for test frameworks vs extensions
- Updates TOC for better navigation hierarchy
- Establishes comprehensive redirects for all renamed/deleted pages
Reviewed changes
Copilot reviewed 40 out of 40 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| docs/core/testing/test-platforms-overview.md | New overview page to help users choose between VSTest and MTP platforms |
| docs/core/testing/microsoft-testing-platform-features.md | New feature overview page replacing generic extensions page |
| docs/core/testing/microsoft-testing-platform-cli-options.md | New consolidated CLI reference replacing scattered option documentation |
| docs/core/testing/microsoft-testing-platform-troubleshooting.md | New troubleshooting page consolidating exit codes and FAQ |
| docs/core/testing/microsoft-testing-platform-terminal-output.md | Feature-specific page extracted from extensions-output.md |
| docs/core/testing/microsoft-testing-platform-test-reports.md | Feature-specific page extracted from extensions-test-reports.md |
| docs/core/testing/microsoft-testing-platform-code-coverage.md | Feature-specific page extracted from extensions-code-coverage.md |
| docs/core/testing/microsoft-testing-platform-crash-hang-dumps.md | Feature-specific page extracted from extensions-diagnostics.md |
| docs/core/testing/microsoft-testing-platform-retry.md | Feature-specific page extracted from extensions-policy.md |
| docs/core/testing/microsoft-testing-platform-hot-reload.md | Feature-specific page extracted from extensions-hosting.md |
| docs/core/testing/microsoft-testing-platform-fakes.md | Feature-specific page from extensions-fakes.md |
| docs/core/testing/microsoft-testing-platform-open-telemetry.md | New OpenTelemetry feature page |
| docs/core/testing/microsoft-testing-platform-telemetry.md | Updated telemetry page with auto-registration info |
| docs/core/testing/microsoft-testing-platform-run-and-debug.md | Extracted run/debug content from intro page |
| docs/core/testing/microsoft-testing-platform-architecture-test-framework.md | Separated test framework architecture from extensions |
| docs/core/testing/microsoft-testing-platform-architecture-extensions.md | Refocused on extensions architecture only |
| docs/core/testing/microsoft-testing-platform-intro.md | Streamlined overview with navigation to other pages |
| docs/core/testing/migrating-vstest-microsoft-testing-platform.md | Updated links and fixed missing quote |
| docs/navigate/devops-testing/toc.yml | Reorganized TOC structure to match new organization |
| .openpublishing.redirection.core.json | Added comprehensive redirects for all moved/renamed pages |
| Various other files | Updated internal links to point to renamed pages |
meaghanlewis
approved these changes
Feb 27, 2026
Contributor
meaghanlewis
left a comment
meaghanlewis
left a comment
There was a problem hiding this comment.
These changes LGTM. Left a handful of suggestions for you to consider.
docs/core/testing/microsoft-testing-platform-crash-hang-dumps.md
Outdated
Show resolved
Hide resolved
Youssef1313
reviewed
Feb 28, 2026
|
|
||
| Specifies the name of the response file. The response file name must immediately follow the @ character with no white space between the @ character and the response file name. | ||
|
|
||
| Options in a response file are interpreted as if they were present at that place in the command line. Each argument in a response file must begin and end on the same line. You cannot use the backslash character (\) to concatenate lines. Using a response file helps for very long commands that might exceed the terminal limits. You can combine a response file with inline command-line arguments. For example: |
Member
There was a problem hiding this comment.
I have doubts about the correctness of this. Having full command-line separated with spaces in a single line should work just fine from MTP point of view.
It only gets problematic when using dotnet test, because in that case it's the SDK command-line parsing that handles response file, and that's when it requires separate line.
Co-authored-by: Meaghan Osagie (Lewis) <mosagie@microsoft.com>
Co-authored-by: Meaghan Osagie (Lewis) <mosagie@microsoft.com>
Co-authored-by: Meaghan Osagie (Lewis) <mosagie@microsoft.com>
Co-authored-by: Meaghan Osagie (Lewis) <mosagie@microsoft.com>
Co-authored-by: Meaghan Osagie (Lewis) <mosagie@microsoft.com>
…-bridge.md Co-authored-by: Meaghan Osagie (Lewis) <mosagie@microsoft.com>
Co-authored-by: Meaghan Osagie (Lewis) <mosagie@microsoft.com>
Co-authored-by: Meaghan Osagie (Lewis) <mosagie@microsoft.com>
Co-authored-by: Meaghan Osagie (Lewis) <mosagie@microsoft.com>
Co-authored-by: Meaghan Osagie (Lewis) <mosagie@microsoft.com>
Co-authored-by: Meaghan Osagie (Lewis) <mosagie@microsoft.com>
Co-authored-by: Meaghan Osagie (Lewis) <mosagie@microsoft.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Explain what are test platforms and how to choose the one to use. Add links to the test frameworks, because that's what people know and will use.
Also refactor MTP doc so that it's easier to browse and look for the info.
Internal previews
Toggle expand/collapse