Skip to content

Add generic MTP capability pages for diagnostics, test host deployment, and Microsoft.Extensions integration#54723

Open
Evangelink wants to merge 2 commits into
mainfrom
dev/amauryleve/mtp-capability-pages
Open

Add generic MTP capability pages for diagnostics, test host deployment, and Microsoft.Extensions integration#54723
Evangelink wants to merge 2 commits into
mainfrom
dev/amauryleve/mtp-capability-pages

Conversation

@Evangelink

@Evangelink Evangelink commented Jul 9, 2026

Copy link
Copy Markdown
Member

Summary

Promotes three experimental Microsoft.Testing.Platform (MTP) extensions from inline blurbs/NuGet links in microsoft-testing-platform-features.md into dedicated, generically named capability pages, each structured to host multiple extensions over time (mirroring the existing Test reports page). Reorganizes features.md to link to them and adds them to the TOC.

New pages

Page Title Hosts today
microsoft-testing-platform-diagnostics.md Diagnostics Video recorder (Microsoft.Testing.Extensions.VideoRecorder, AddVideoRecorderProvider())
microsoft-testing-platform-test-host-deployment.md Test host deployment Packaged app deployment (Microsoft.Testing.Extensions.PackagedApp, AddPackagedAppDeployment())
microsoft-testing-platform-extensions-integration.md Microsoft.Extensions integration Logging bridge (Microsoft.Testing.Extensions.Logging, AddMicrosoftExtensionsLogging(...))

Each follows the extension-section pattern from microsoft-testing-platform-test-reports.md: H1 + intro, per-extension ## <name> with NuGet-package line, experimental > [!NOTE], ### Manual registration C# block, and (video recorder only) a ### Options table in the three-column | Option | MTP version | Description | format.

Content source breakdown

diagnostics.md — Video recorder

  • Copied/adapted: capability summary and ffmpeg/--capture-video opt-in framing (from the features.md blurb).
  • Verified from source (microsoft/testfx VideoRecorderCommandLineProvider.cs, PACKAGE.md, PublicAPI.Shipped.txt): package id, AddVideoRecorderProvider(), [TPEXP] experimental status, and all six options with their valid values/defaults — --capture-video (on-failure default / always), --capture-video-source (screen default / window), --capture-video-granularity (test default / session), --capture-video-max-duration (positive int seconds), --capture-video-chapters (on default / off), --capture-video-args. Sub-options require --capture-video.
  • Newly written: the related-capability cross-link to Crash and hang dumps.

test-host-deployment.md — Packaged app deployment

  • Copied/adapted: the ITestHostLauncher reference-extension framing (from the features.md blurb).
  • Verified from source (PackagedAppExtensions.cs, PACKAGE.md, PublicAPI.Shipped.txt): package id, AddPackagedAppDeployment(), [TPEXP] status, UWP/packaged-WinUI deploy-and-launch behavior. No CLI options exist, so no Options table.

extensions-integration.md — Logging bridge

  • Copied verbatim: the registration C# sample from features.md.
  • Verified from source (MicrosoftExtensionsLoggingBuilderExtensions.cs, PACKAGE.md, PublicAPI.Shipped.txt, RFC 013): package id, AddMicrosoftExtensionsLogging(...), [TPEXP] status, bridge to xref:Microsoft.Extensions.Logging.ILogger, the no-op-when---diagnostic-off behavior, and that per-category filters can narrow but not widen the effective level. No CLI options.

features.md

  • Removed inline Video recorder, Packaged app deployment, and Logging bridge entries; replaced with links to the three new pages.
  • Updated the Choose by scenario list with three new bullets.
  • Removed the now-redundant ## Microsoft.Extensions integration subsection body (folded into the Extension features list).

toc.yml — added the three pages next to the other MTP extension entries.

Needs expert review

  • Versioning: all three pages state MTP 2.3.0 (carried over from the existing features.md blurbs and the task decision). Source glossary.md/PACKAGE.md describe the PackagedApp package as shipping 1.0.0-alpha; please confirm the 2.3.0 platform-version framing for each extension.
  • Experimental note wording: reused the standard HTML/JUnit/CTRF sentence ("Available in MTP starting with version 2.3.0. This extension is experimental, and its options and output format might change in a future version."). Confirm this reads correctly for these capabilities.
  • Video recorder options: verified against the current source provider; confirm defaults/arity match the shipped 2.3.0 build.

All internal links and cross-references were checked to resolve.

ai-usage: ai-generated


Internal previews

📄 File 🔗 Preview link
docs/core/testing/microsoft-testing-platform-diagnostics.md Diagnostics
docs/core/testing/microsoft-testing-platform-extensions-integration.md Microsoft.Extensions integration
docs/core/testing/microsoft-testing-platform-features.md Microsoft.Testing.Platform features
docs/core/testing/microsoft-testing-platform-test-host-deployment.md Test host deployment
docs/navigate/devops-testing/toc.yml docs/navigate/devops-testing/toc

…t, and Microsoft.Extensions integration

Promote the experimental video recorder, packaged-app deployment, and logging-bridge extensions from inline blurbs in features.md into dedicated, generically named capability pages that can host multiple extensions over time. Update features.md links, the Choose by scenario list, and the TOC.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 9, 2026 12:57
@Evangelink Evangelink requested review from a team, meaghanlewis and nohwnd as code owners July 9, 2026 12:57
@dotnetrepoman dotnetrepoman Bot added this to the July 2026 milestone Jul 9, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

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 promotes three experimental Microsoft.Testing.Platform (MTP) extensions from brief entries in microsoft-testing-platform-features.md into dedicated capability pages, and wires those pages into navigation.

Changes:

  • Added three new capability pages: Diagnostics, Test host deployment, and Microsoft.Extensions integration.
  • Updated the MTP features page to link to the new capability pages instead of hosting inline blurbs/samples.
  • Updated the DevOps testing TOC to include the new pages.
Show a summary per file
File Description
docs/navigate/devops-testing/toc.yml Adds TOC entries for the three new MTP capability pages.
docs/core/testing/microsoft-testing-platform-test-host-deployment.md New capability page for extensions that deploy and launch the test host (packaged app deployment).
docs/core/testing/microsoft-testing-platform-features.md Replaces inline blurbs with links to the new capability pages and updates scenario bullets.
docs/core/testing/microsoft-testing-platform-extensions-integration.md New capability page for Microsoft.Extensions integration (logging bridge).
docs/core/testing/microsoft-testing-platform-diagnostics.md New capability page for diagnostics (video recorder + options table).

Copilot's findings

  • Files reviewed: 5/5 changed files
  • Comments generated: 1

Comment thread docs/core/testing/microsoft-testing-platform-extensions-integration.md Outdated
@Evangelink Evangelink enabled auto-merge (squash) July 9, 2026 16:45
- Align extensions-integration.md frontmatter title with the MTP capability-page convention (prefix with 'Microsoft.Testing.Platform (MTP)').

- Remove the stale microsoft-testing-platform-diagnostics.md redirect entry now that the page exists, resolving the redirected-file-not-removed build warning.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants