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 1 commit
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 Microsoft.Testing.Platform 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 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 Microsoft.Testing.Platform available 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 Microsoft.Test
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 Microsoft.Testing.Pl
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 Microsoft.Testing.Platform using configurati
author: Evangelink
ms.author: amauryleve
ms.date: 08/15/2024
ms.custom: microsoft-testing-platform,MTP
---

# Microsoft.Testing.Platform 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 Microsoft.Testing.Platform extensions for collectin
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 various Microsoft.Testing.Platform VSTest bridge ex
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 Microsoft.Testing.Platform Fakes extension capabili
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 Microsoft.Testing.Platform Hot Reload extension for
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 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 Microsoft.Testing.Platform v2 and understan
author: Youssef1313
ms.author: ygerges
ms.date: 10/08/2025
ms.custom: microsoft-testing-platform,MTP
---

# Migrate from Microsoft.Testing.Platform 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 Microsoft.Testing.Platform.
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 Microsoft.Testing.Platform test projects
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 Microsoft.Testing.Platf
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 Microsoft.Testin
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 Microsoft.Testing.Platform extensions for generatin
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 Microsoft.Testing.Platform issues, exit codes, and kno
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
description: Learn how to migrate from VSTest to Microsoft.Testing.Platform
Comment thread
Evangelink marked this conversation as resolved.
Outdated
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
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 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
description: The dotnet test command is used to execute unit tests in a given project using Microsoft.Testing.Platform (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