Skip to content

Improve SEO for Microsoft.Testing.Platform (MTP) documentation #53355

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Evangelink wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Improve SEO for Microsoft.Testing.Platform (MTP) documentation #53355

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
4f06e96
Improve SEO for Microsoft.Testing.Platform documentation
Evangelink Apr 23, 2026
026ac76
Merge remote-tracking branch 'origin/main' into mtp-seo-improvements
Copilot Apr 25, 2026
ea10422
Move ms.custom to docfx.json file glob, simplify to single value
Copilot Apr 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-architecture-capabilities.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn about MTP capabilities concept.
author: MarcoRossignoli
ms.author: mrossignoli
ms.date: 07/11/2024
ms.custom: microsoft-testing-platform,MTP
Comment thread
Evangelink marked this conversation as resolved.
Outdated
---

# Microsoft.Testing.Platform (MTP) capabilities
Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-architecture-extensions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn how to create in-process and out-of-process extensions for Mi
author: MarcoRossignoli
ms.author: mrossignoli
ms.date: 02/24/2026
ms.custom: microsoft-testing-platform,MTP
Copy link
Copy Markdown
Member

@Youssef1313 Youssef1313 Apr 26, 2026

Choose a reason for hiding this comment

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

As this is only for internal purposes, I think having two values is redundant.

Copy link
Copy Markdown
Member

@Youssef1313 Youssef1313 Apr 26, 2026

Choose a reason for hiding this comment

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

Consider also applying it globally in docfx.json via a file glob. Example

Copy link
Copy Markdown
Member Author

@Evangelink Evangelink Apr 26, 2026

Choose a reason for hiding this comment

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

@copilot please apply change suggested by Youssef. Don't forget to clean up local definitions once this is setup globally.

Copy link
Copy Markdown
Contributor

Copilot AI Apr 26, 2026

Choose a reason for hiding this comment

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

Done in commit ea10422. Moved ms.custom from all 26 individual frontmatter entries to docfx.json using file globs, and simplified the value to the single microsoft-testing-platform string:

"ms.custom": {
    "docs/ai/**/**.{md,yml}": "devx-track-dotnet",
    "docs/core/testing/*microsoft-testing-platform*.md": "microsoft-testing-platform",
    "docs/core/testing/test-platforms-overview.md": "microsoft-testing-platform",
    "docs/core/testing/unit-testing-with-dotnet-test.md": "microsoft-testing-platform",
    "docs/core/tools/dotnet-test-mtp.md": "microsoft-testing-platform"
},

The glob docs/core/testing/*microsoft-testing-platform*.md covers 23 files (including migrating-vstest-microsoft-testing-platform.md). The remaining 3 files have individual entries.

ai-usage: ai-assisted
---

Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-architecture-services.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn about the available Microsoft.Testing.Platform (MTP) services
author: MarcoRossignoli
ms.author: mrossignoli
ms.date: 07/11/2024
ms.custom: microsoft-testing-platform,MTP
---

# Microsoft.Testing.Platform services
Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-architecture-test-framework.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn how to create a custom test framework for Microsoft.Testing.P
author: MarcoRossignoli
ms.author: mrossignoli
ms.date: 02/24/2026
ms.custom: microsoft-testing-platform,MTP
ai-usage: ai-assisted
---

Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-architecture.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn how to build custom test frameworks and extensions for Micros
author: MarcoRossignoli
ms.author: mrossignoli
ms.date: 02/24/2026
ms.custom: microsoft-testing-platform,MTP
ai-usage: ai-assisted
---

Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-cli-options.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Find platform and extension command-line options for MTP in one pla
author: Evangelink
ms.author: amauryleve
ms.date: 02/24/2026
ms.custom: microsoft-testing-platform,MTP
ai-usage: ai-assisted
---

Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-code-coverage.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn about collecting code coverage data with MTP.
author: evangelink
ms.author: amauryleve
ms.date: 02/25/2026
ms.custom: microsoft-testing-platform,MTP
ai-usage: ai-assisted
---

Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-config.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn how to configure MTP using configuration settings.
author: Evangelink
ms.author: amauryleve
ms.date: 08/15/2024
ms.custom: microsoft-testing-platform,MTP
---

# Microsoft.Testing.Platform (MTP) configuration settings
Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-crash-hang-dumps.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn about the MTP extensions for collecting crash dumps and hang
author: evangelink
ms.author: amauryleve
ms.date: 02/25/2026
ms.custom: microsoft-testing-platform,MTP
ai-usage: ai-assisted
---

Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-extensions-vstest-bridge.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn about the MTP VSTest bridge extension and how to use it.
author: evangelink
ms.author: amauryleve
ms.date: 04/10/2024
ms.custom: microsoft-testing-platform,MTP
---

# VSTest Bridge extension
Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-fakes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn about the MTP Fakes extension capabilities and how to use it.
author: drognanar
ms.author: arturs
ms.date: 02/25/2026
ms.custom: microsoft-testing-platform,MTP
ai-usage: ai-assisted
---

Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-features.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn about the various Microsoft.Testing.Platform features, both b
author: nohwnd
ms.author: jajares
ms.date: 02/25/2026
ms.custom: microsoft-testing-platform,MTP
ai-usage: ai-assisted
---

Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-hot-reload.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn about the MTP Hot Reload extension for running tests with hot
author: evangelink
ms.author: amauryleve
ms.date: 02/25/2026
ms.custom: microsoft-testing-platform,MTP
ai-usage: ai-assisted
---

Expand Down
5 changes: 3 additions & 2 deletions docs/core/testing/microsoft-testing-platform-intro.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,10 @@
---
title: Microsoft.Testing.Platform overview
description: Learn about Microsoft.Testing.Platform, a lightweight way to run tests without depending on the .NET SDK.
title: Microsoft.Testing.Platform overview - .NET test runner
description: Learn about Microsoft.Testing.Platform (MTP), a lightweight and portable .NET test runner and VSTest alternative for running unit tests in CI pipelines, CLI, and IDEs.
author: Evangelink
ms.author: amauryleve
ms.date: 03/17/2024
ms.custom: microsoft-testing-platform,MTP
---

# Microsoft.Testing.Platform (MTP) overview
Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-migration-from-v1-to-v2.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn how to migrate to MTP v2 and understand the key changes.
author: Youssef1313
ms.author: ygerges
ms.date: 10/08/2025
ms.custom: microsoft-testing-platform,MTP
---

# Migrate from Microsoft.Testing.Platform (MTP) v1 to v2
Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-open-telemetry.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn how to use the OpenTelemetry extension to emit traces and met
author: Evangelink
ms.author: amauryleve
ms.date: 02/25/2026
ms.custom: microsoft-testing-platform,MTP
ai-usage: ai-assisted
---

Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-retry.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn about retrying failed tests with MTP.
author: evangelink
ms.author: amauryleve
ms.date: 02/25/2026
ms.custom: microsoft-testing-platform,MTP
ai-usage: ai-assisted
---

Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-run-and-debug.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn how to run and debug MTP test projects from CLI, Visual Studi
author: Evangelink
ms.author: amauryleve
ms.date: 02/24/2026
ms.custom: microsoft-testing-platform,MTP
ai-usage: ai-assisted
---

Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-telemetry.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn about the telemetry data collected by MTP and how to disable
author: nohwnd
ms.author: jajares
ms.date: 02/25/2026
ms.custom: microsoft-testing-platform,MTP
ai-usage: ai-assisted
---

Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-terminal-output.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn about the built-in terminal test reporter in MTP, including o
author: evangelink
ms.author: amauryleve
ms.date: 02/25/2026
ms.custom: microsoft-testing-platform,MTP
ai-usage: ai-assisted
---

Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-test-reports.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn about the MTP extensions for generating test report files (TR
author: evangelink
ms.author: amauryleve
ms.date: 02/25/2026
ms.custom: microsoft-testing-platform,MTP
ai-usage: ai-assisted
---

Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/microsoft-testing-platform-troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Troubleshoot MTP issues, exit codes, and known problems.
author: Evangelink
ms.author: amauryleve
ms.date: 02/24/2026
ms.custom: microsoft-testing-platform,MTP
ai-usage: ai-assisted
---

Expand Down
3 changes: 2 additions & 1 deletion docs/core/testing/migrating-vstest-microsoft-testing-platform.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,10 @@
---
title: Migration guide from VSTest to Microsoft.Testing.Platform (MTP)
description: Learn how to migrate from VSTest to MTP
description: Step-by-step guide to migrate from VSTest to Microsoft.Testing.Platform (MTP), including argument mapping, project configuration, and CI pipeline updates.
author: Youssef1313
ms.author: ygerges
ms.date: 09/15/2025
ms.custom: microsoft-testing-platform,MTP
---

# Migrate from VSTest to Microsoft.Testing.Platform (MTP)
Expand Down
5 changes: 3 additions & 2 deletions docs/core/testing/test-platforms-overview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,10 @@
---
title: Test platforms overview for .NET
description: Learn how VSTest and Microsoft.Testing.Platform (MTP) differ, and choose the right test platform for your .NET test projects.
title: Microsoft.Testing.Platform vs VSTest - .NET test platform comparison
description: Compare Microsoft.Testing.Platform (MTP) and VSTest to choose the right .NET test platform for your projects, CI pipelines, and IDE integration.
author: Evangelink
ms.author: amauryleve
ms.date: 02/24/2026
ms.custom: microsoft-testing-platform,MTP
ai-usage: ai-assisted
---

Expand Down
1 change: 1 addition & 0 deletions docs/core/testing/unit-testing-with-dotnet-test.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Learn more about how 'dotnet test' works and its support for VSTest
author: Youssef1313
ms.author: ygerges
ms.date: 03/26/2025
ms.custom: microsoft-testing-platform,MTP
---

# Testing with 'dotnet test'
Expand Down
1 change: 1 addition & 0 deletions docs/core/tools/dotnet-test-mtp.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
title: dotnet test command with Microsoft.Testing.Platform (MTP)
description: The dotnet test command is used to execute unit tests in a given project using MTP.
ms.date: 02/03/2026
ms.custom: microsoft-testing-platform,MTP
ai-usage: ai-assisted
---
# dotnet test with Microsoft.Testing.Platform (MTP)
Expand Down
30 changes: 29 additions & 1 deletion docs/navigate/devops-testing/toc.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ items:
href: ../../devops/dotnet-secure-github-action.md
displayName: codeql,security,vulnerability,source scan
- name: Testing
displayName: xUnit,NUnit,MSTest,unit test,test,integration test,load test,smoke test, web test
displayName: xUnit,NUnit,MSTest,unit test,test,integration test,load test,smoke test,web test,Microsoft.Testing.Platform,MTP,testing platform,test runner
Comment thread
Youssef1313 marked this conversation as resolved.
items:
- name: Overview
href: ../../core/testing/index.md
Expand Down Expand Up @@ -257,60 +257,88 @@ items:
items:
- name: Overview
href: ../../core/testing/test-platforms-overview.md
displayName: MTP vs VSTest,compare test platforms,choose test platform
Comment thread
Youssef1313 marked this conversation as resolved.
- name: Microsoft.Testing.Platform
displayName: MTP,testing platform,.NET test runner,VSTest alternative
items:
- name: Overview
href: ../../core/testing/microsoft-testing-platform-intro.md
displayName: MTP,testing platform,test runner,VSTest alternative
- name: Run and debug tests
href: ../../core/testing/microsoft-testing-platform-run-and-debug.md
displayName: MTP,run tests,debug tests,dotnet test,CI pipeline
- name: CLI options reference
href: ../../core/testing/microsoft-testing-platform-cli-options.md
displayName: MTP,command line,CLI,options,arguments,switches
- name: Configuration
href: ../../core/testing/microsoft-testing-platform-config.md
displayName: MTP,testconfig.json,configuration,settings
- name: Troubleshooting
href: ../../core/testing/microsoft-testing-platform-troubleshooting.md
displayName: MTP,exit codes,errors,troubleshoot
- name: Features
displayName: MTP features,extensions,NuGet
items:
- name: Overview
href: ../../core/testing/microsoft-testing-platform-features.md
displayName: MTP features,extensions
- name: Terminal output
href: ../../core/testing/microsoft-testing-platform-terminal-output.md
displayName: MTP,terminal,test reporter,ANSI,progress
- name: Test reports
href: ../../core/testing/microsoft-testing-platform-test-reports.md
displayName: MTP,TRX,test report,Azure DevOps
- name: Code coverage
href: ../../core/testing/microsoft-testing-platform-code-coverage.md
displayName: MTP,code coverage,coverage
- name: Crash and hang dumps
href: ../../core/testing/microsoft-testing-platform-crash-hang-dumps.md
displayName: MTP,crash dump,hang dump,diagnostics
- name: OpenTelemetry
href: ../../core/testing/microsoft-testing-platform-open-telemetry.md
displayName: MTP,OpenTelemetry,traces,metrics
- name: Retry
href: ../../core/testing/microsoft-testing-platform-retry.md
displayName: MTP,retry,flaky tests
- name: Hot Reload
href: ../../core/testing/microsoft-testing-platform-hot-reload.md
displayName: MTP,hot reload,live reload
- name: Microsoft Fakes
href: ../../core/testing/microsoft-testing-platform-fakes.md
displayName: MTP,fakes,shims,stubs
- name: Telemetry
href: ../../core/testing/microsoft-testing-platform-telemetry.md
displayName: MTP,telemetry,opt out
- name: Migration
displayName: MTP,migrate,VSTest migration
items:
- name: Migrate from VSTest
href: ../../core/testing/migrating-vstest-microsoft-testing-platform.md
displayName: MTP,VSTest,migration,migrate,switch
- name: Migrate from MTP v1 to v2
href: ../../core/testing/microsoft-testing-platform-migration-from-v1-to-v2.md
displayName: MTP v2,upgrade,breaking changes
- name: Create custom extensions
displayName: MTP,extensibility,custom extensions
items:
- name: Overview
href: ../../core/testing/microsoft-testing-platform-architecture.md
displayName: MTP,architecture,custom test framework,extensibility
- name: Build a test framework
href: ../../core/testing/microsoft-testing-platform-architecture-test-framework.md
displayName: MTP,custom test framework,ITestFramework
- name: VSTest Bridge
href: ../../core/testing/microsoft-testing-platform-extensions-vstest-bridge.md
displayName: MTP,VSTest bridge,backward compatibility
- name: Build extensions
href: ../../core/testing/microsoft-testing-platform-architecture-extensions.md
displayName: MTP,extensions,in-process,out-of-process
- name: Capabilities
href: ../../core/testing/microsoft-testing-platform-architecture-capabilities.md
displayName: MTP,capabilities
- name: Services
href: ../../core/testing/microsoft-testing-platform-architecture-services.md
displayName: MTP,services,IServiceProvider
- name: VSTest
href: https://github.com/microsoft/vstest
- name: Testing with 'dotnet test'
Expand Down
Loading