Improve SEO for Microsoft.Testing.Platform (MTP) documentation#53355
Open
Evangelink wants to merge 1 commit intomainfrom
Open
Improve SEO for Microsoft.Testing.Platform (MTP) documentation#53355Evangelink wants to merge 1 commit intomainfrom
Evangelink wants to merge 1 commit intomainfrom
Conversation
- Add displayName entries to all MTP TOC nodes in toc.yml for better learn.microsoft.com search and sitemap coverage - Add ms.custom: microsoft-testing-platform,MTP to all 26 MTP-related pages for internal search indexing - Improve title and description of test-platforms-overview.md to capture 'MTP vs VSTest' comparison queries - Enrich intro page description with additional search terms (.NET test runner, VSTest alternative, CI pipelines, IDEs) - Improve migration guide description with specific terms (argument mapping, project configuration, CI pipeline updates)
Evangelink
requested review from
a team,
Youssef1313 and
meaghanlewis
as code owners
Contributor
There was a problem hiding this comment.
Pull request overview
Note
Copilot was unable to run its full agentic suite in this review.
Improves SEO and on-site discoverability for Microsoft.Testing.Platform (MTP) documentation by enriching Learn metadata and navigation entries with MTP-related search terms.
Changes:
- Added
displayNamekeywords across the DevOps Testing TOC, including all MTP-related nodes. - Added
ms.custom: microsoft-testing-platform,MTPto MTP-related documentation pages to improve internal search indexing. - Updated select page titles/descriptions to better match intent-based queries (e.g., “MTP vs VSTest”).
Show a summary per file
| File | Description |
|---|---|
| docs/navigate/devops-testing/toc.yml | Adds MTP-focused displayName keywords throughout Testing TOC entries to improve Learn search/sitemap metadata. |
| docs/core/tools/dotnet-test-mtp.md | Adds ms.custom metadata for improved indexing of the dotnet test + MTP page. |
| docs/core/testing/unit-testing-with-dotnet-test.md | Adds ms.custom metadata to connect dotnet test guidance with MTP discovery. |
| docs/core/testing/test-platforms-overview.md | Updates title/description for “MTP vs VSTest” search intent and adds ms.custom. |
| docs/core/testing/migrating-vstest-microsoft-testing-platform.md | Enriches description with migration-specific keywords and adds ms.custom. |
| docs/core/testing/microsoft-testing-platform-troubleshooting.md | Adds ms.custom metadata for troubleshooting page indexing. |
| docs/core/testing/microsoft-testing-platform-test-reports.md | Adds ms.custom metadata for test reports page indexing. |
| docs/core/testing/microsoft-testing-platform-terminal-output.md | Adds ms.custom metadata for terminal output page indexing. |
| docs/core/testing/microsoft-testing-platform-telemetry.md | Adds ms.custom metadata for telemetry page indexing. |
| docs/core/testing/microsoft-testing-platform-run-and-debug.md | Adds ms.custom metadata for run/debug page indexing. |
| docs/core/testing/microsoft-testing-platform-retry.md | Adds ms.custom metadata for retry page indexing. |
| docs/core/testing/microsoft-testing-platform-open-telemetry.md | Adds ms.custom metadata for OpenTelemetry page indexing. |
| docs/core/testing/microsoft-testing-platform-migration-from-v1-to-v2.md | Adds ms.custom metadata for v1→v2 migration page indexing. |
| docs/core/testing/microsoft-testing-platform-intro.md | Updates title/description with search keywords and adds ms.custom. |
| docs/core/testing/microsoft-testing-platform-hot-reload.md | Adds ms.custom metadata for hot reload page indexing. |
| docs/core/testing/microsoft-testing-platform-features.md | Adds ms.custom metadata for features overview page indexing. |
| docs/core/testing/microsoft-testing-platform-fakes.md | Adds ms.custom metadata for Microsoft Fakes extension page indexing. |
| docs/core/testing/microsoft-testing-platform-extensions-vstest-bridge.md | Adds ms.custom metadata for VSTest bridge extension page indexing. |
| docs/core/testing/microsoft-testing-platform-crash-hang-dumps.md | Adds ms.custom metadata for crash/hang dumps page indexing. |
| docs/core/testing/microsoft-testing-platform-config.md | Adds ms.custom metadata for configuration page indexing. |
| docs/core/testing/microsoft-testing-platform-code-coverage.md | Adds ms.custom metadata for code coverage page indexing. |
| docs/core/testing/microsoft-testing-platform-cli-options.md | Adds ms.custom metadata for CLI options page indexing. |
| docs/core/testing/microsoft-testing-platform-architecture.md | Adds ms.custom metadata for architecture overview page indexing. |
| docs/core/testing/microsoft-testing-platform-architecture-test-framework.md | Adds ms.custom metadata for test framework extensibility page indexing. |
| docs/core/testing/microsoft-testing-platform-architecture-services.md | Adds ms.custom metadata for services page indexing. |
| docs/core/testing/microsoft-testing-platform-architecture-extensions.md | Adds ms.custom metadata for extensions page indexing. |
| docs/core/testing/microsoft-testing-platform-architecture-capabilities.md | Adds ms.custom metadata for capabilities page indexing. |
Copilot's findings
- Files reviewed: 27/27 changed files
- Comments generated: 0
Youssef1313
reviewed
Apr 23, 2026
Youssef1313
reviewed
Apr 23, 2026
| @@ -1,9 +1,10 @@ | |||
| --- | |||
| title: Migration guide from VSTest to Microsoft.Testing.Platform | |||
| description: Learn how to migrate from VSTest to Microsoft.Testing.Platform | |||
Member
There was a problem hiding this comment.
I might have been taking the wording from other migration guides.
Youssef1313
reviewed
Apr 23, 2026
Youssef1313
reviewed
Apr 23, 2026
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
Improves search engine discoverability for Microsoft.Testing.Platform (MTP) documentation pages on learn.microsoft.com.
Related to #51830 and complements #53354.
Changes
1. Add
displayNameto TOC entries (high impact)The
displayNamefield intoc.ymldrives learn.microsoft.com site search and sitemap metadata. Previously:displayNameNow all MTP entries have
displayNamewith relevant search terms (MTP, testing platform, .NET test runner, VSTest alternative, etc.).2. Add
ms.custommetadata to all MTP pages (medium impact)Added
ms.custom: microsoft-testing-platform,MTPto all 26 MTP-related pages. This field feeds into internal search indexing on learn.microsoft.com.3. Improve key page titles and descriptions (high impact)
Files changed
docs/navigate/devops-testing/toc.ymlmicrosoft-testing-platform-*.mdpages plus related pages (test-platforms-overview, migration guide, dotnet-test-mtp, unit-testing-with-dotnet-test)Internal previews
Toggle expand/collapse