From 5b60f2a4f444f2aafa4094e25bbb7e962fa574d2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Amaury=20Lev=C3=A9?= Date: Sun, 22 Feb 2026 13:40:18 +0100 Subject: [PATCH 1/8] Rework NuGet PACKAGE.md for Microsoft.Testing.Platform and extensions Rework all NuGet README files (PACKAGE.md) for Microsoft.Testing.Platform and its extensions with a unified, detailed style: - Use the actual package name as the title instead of generic 'Microsoft.Testing' - Add a descriptive introduction paragraph with a NuGet link to Microsoft.Testing.Platform - Add 'Install the package' section with dotnet CLI command - Add detailed 'About' section with key features as bullet points - Add 'Related packages' cross-references for closely related extensions (diagnostics: CrashDump/HangDump, reporting: TrxReport/TrxReport.Abstractions/AzureDevOpsReport, AI: Platform.AI/AzureFoundry) - Add 'Documentation' and 'Feedback & contributing' sections with links - Add missing PACKAGE.md for Microsoft.Testing.Platform.AI and Microsoft.Testing.Extensions.AzureFoundry - Clarify VSTestBridge is a test framework author extension, not for end-user projects - Clarify OpenTelemetry extension sends data only to user-configured endpoints, not to Microsoft --- .../PACKAGE.md | 30 ++++++++++++++--- .../PACKAGE.md | 33 +++++++++++++++++++ .../PACKAGE.md | 32 +++++++++++++++--- .../PACKAGE.md | 32 +++++++++++++++--- .../PACKAGE.md | 26 ++++++++++++--- .../PACKAGE.md | 27 ++++++++++++--- .../PACKAGE.md | 28 +++++++++++++--- .../PACKAGE.md | 28 +++++++++++++--- .../PACKAGE.md | 31 ++++++++++++++--- .../PACKAGE.md | 33 ++++++++++++++++--- .../PACKAGE.md | 28 +++++++++++++--- .../Microsoft.Testing.Platform.AI/PACKAGE.md | 33 +++++++++++++++++++ .../PACKAGE.md | 27 ++++++++++++--- .../Microsoft.Testing.Platform/PACKAGE.md | 32 +++++++++++++++--- 14 files changed, 371 insertions(+), 49 deletions(-) create mode 100644 src/Platform/Microsoft.Testing.Extensions.AzureFoundry/PACKAGE.md create mode 100644 src/Platform/Microsoft.Testing.Platform.AI/PACKAGE.md diff --git a/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport/PACKAGE.md index 214ac847f6..e64cc92b3a 100644 --- a/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport/PACKAGE.md @@ -1,9 +1,31 @@ -# Microsoft.Testing +# Microsoft.Testing.Extensions.AzureDevOpsReport -Microsoft Testing is a set of platform, framework and protocol intended to make it possible to run any test on any target or device. +Microsoft.Testing.Extensions.AzureDevOpsReport is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that provides real-time test result reporting for Azure DevOps Pipelines. -Documentation can be found at . +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.AzureDevOpsReport` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport) GitHub repository. + +## Install the package + +```dotnetcli +dotnet add package Microsoft.Testing.Extensions.AzureDevOpsReport +``` ## About -This package extends Microsoft Testing Platform to provide Azure DevOps reporting. +This package extends Microsoft.Testing.Platform with: + +- **Real-time test reporting**: reports individual test results to Azure DevOps as they complete +- **Pipeline integration**: automatically detects Azure DevOps Pipelines environments +- **Test run summaries**: provides rich test result summaries visible in the Azure DevOps Pipeline UI + +## Related packages + +- [Microsoft.Testing.Extensions.TrxReport](https://www.nuget.org/packages/Microsoft.Testing.Extensions.TrxReport): TRX report generation for standardized test result files + +## Documentation + +For comprehensive documentation, see . + +## Feedback & contributing + +Microsoft.Testing.Platform is an open source project. Provide feedback or report issues in the [microsoft/testfx](https://github.com/microsoft/testfx/issues) GitHub repository. diff --git a/src/Platform/Microsoft.Testing.Extensions.AzureFoundry/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.AzureFoundry/PACKAGE.md new file mode 100644 index 0000000000..4f07268e13 --- /dev/null +++ b/src/Platform/Microsoft.Testing.Extensions.AzureFoundry/PACKAGE.md @@ -0,0 +1,33 @@ +# Microsoft.Testing.Extensions.AzureFoundry + +Microsoft.Testing.Extensions.AzureFoundry is an AI provider extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that integrates with Azure AI Foundry (Azure OpenAI) to enable AI-powered testing capabilities. + +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.AzureFoundry` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.AzureFoundry) GitHub repository. + +## Install the package + +```dotnetcli +dotnet add package Microsoft.Testing.Extensions.AzureFoundry +``` + +## About + +This package extends Microsoft.Testing.Platform with: + +- **Azure AI Foundry integration**: provides an `IChatClientProvider` implementation backed by Azure OpenAI +- **AI-powered test analysis**: enables extensions to leverage LLMs for intelligent testing activities such as crash dump analysis, hang analysis, flaky test detection and test failure root cause analysis +- **Automatic configuration**: discovers Azure AI settings from environment variables for seamless CI integration + +This package is a reference implementation of the [Microsoft.Testing.Platform.AI](https://www.nuget.org/packages/Microsoft.Testing.Platform.AI) abstractions. + +## Related packages + +- [Microsoft.Testing.Platform.AI](https://www.nuget.org/packages/Microsoft.Testing.Platform.AI): AI extensibility abstractions for the testing platform + +## Documentation + +For comprehensive documentation, see . + +## Feedback & contributing + +Microsoft.Testing.Platform is an open source project. Provide feedback or report issues in the [microsoft/testfx](https://github.com/microsoft/testfx/issues) GitHub repository. diff --git a/src/Platform/Microsoft.Testing.Extensions.CrashDump/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.CrashDump/PACKAGE.md index 88c8efbf23..ad90ce2e35 100644 --- a/src/Platform/Microsoft.Testing.Extensions.CrashDump/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.CrashDump/PACKAGE.md @@ -1,9 +1,33 @@ -# Microsoft.Testing +# Microsoft.Testing.Extensions.CrashDump -Microsoft Testing is a set of platform, framework and protocol intended to make it possible to run any test on any target or device. +Microsoft.Testing.Extensions.CrashDump is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that captures a crash dump of the test host process when an unhandled exception or crash occurs. -Documentation can be found at . +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.CrashDump` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.CrashDump) GitHub repository. + +## Install the package + +```dotnetcli +dotnet add package Microsoft.Testing.Extensions.CrashDump +``` ## About -This package extends Microsoft Testing Platform to provide a crash dump functionality. +This package extends Microsoft.Testing.Platform with: + +- **Crash dump collection**: automatically captures a memory dump when the test process crashes +- **Post-mortem debugging**: collected dumps can be analyzed with tools like Visual Studio, WinDbg, or `dotnet-dump` +- **CI-friendly**: crash dumps are saved to the test results directory for easy retrieval in CI pipelines + +Enable crash dump collection via the `--crashdump` command line option. + +## Related packages + +- [Microsoft.Testing.Extensions.HangDump](https://www.nuget.org/packages/Microsoft.Testing.Extensions.HangDump): captures dumps when the test process hangs + +## Documentation + +For comprehensive documentation, see . + +## Feedback & contributing + +Microsoft.Testing.Platform is an open source project. Provide feedback or report issues in the [microsoft/testfx](https://github.com/microsoft/testfx/issues) GitHub repository. diff --git a/src/Platform/Microsoft.Testing.Extensions.HangDump/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.HangDump/PACKAGE.md index 776c34d531..2f102eb6d3 100644 --- a/src/Platform/Microsoft.Testing.Extensions.HangDump/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.HangDump/PACKAGE.md @@ -1,9 +1,33 @@ -# Microsoft.Testing +# Microsoft.Testing.Extensions.HangDump -Microsoft Testing is a set of platform, framework and protocol intended to make it possible to run any test on any target or device. +Microsoft.Testing.Extensions.HangDump is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that captures a memory dump when the test host process appears to be hung (exceeds a configurable timeout). -Documentation can be found at . +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.HangDump` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.HangDump) GitHub repository. + +## Install the package + +```dotnetcli +dotnet add package Microsoft.Testing.Extensions.HangDump +``` ## About -This package provides Windows Hang dump extensions to Microsoft Testing Platform. +This package extends Microsoft.Testing.Platform with: + +- **Hang detection**: monitors the test host process and detects when it exceeds a configurable timeout +- **Dump collection**: captures a memory dump of the hanging process for post-mortem analysis +- **Deadlock investigation**: collected dumps can be analyzed with tools like Visual Studio, WinDbg, or `dotnet-dump` to diagnose deadlocks and other hang causes + +Enable hang dump collection via the `--hangdump` command line option, and configure the timeout with `--hangdump-timeout`. + +## Related packages + +- [Microsoft.Testing.Extensions.CrashDump](https://www.nuget.org/packages/Microsoft.Testing.Extensions.CrashDump): captures dumps when the test process crashes + +## Documentation + +For comprehensive documentation, see . + +## Feedback & contributing + +Microsoft.Testing.Platform is an open source project. Provide feedback or report issues in the [microsoft/testfx](https://github.com/microsoft/testfx/issues) GitHub repository. diff --git a/src/Platform/Microsoft.Testing.Extensions.HotReload/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.HotReload/PACKAGE.md index 7975720586..7854bc024e 100644 --- a/src/Platform/Microsoft.Testing.Extensions.HotReload/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.HotReload/PACKAGE.md @@ -1,9 +1,27 @@ -# Microsoft.Testing +# Microsoft.Testing.Extensions.HotReload -Microsoft Testing is a set of platform, framework and protocol intended to make it possible to run any test on any target or device. +Microsoft.Testing.Extensions.HotReload is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that enables Hot Reload support, allowing you to apply code changes to your running tests without restarting the test host process. -Documentation can be found at . +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.HotReload` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.HotReload) GitHub repository. + +## Install the package + +```dotnetcli +dotnet add package Microsoft.Testing.Extensions.HotReload +``` ## About -This package extends Microsoft Testing Platform to provide Hot Reload support. +This package extends Microsoft.Testing.Platform with: + +- **Hot Reload integration**: apply code changes to your test project without restarting the test host +- **Faster inner loop**: reduces the time between making a change and seeing the test results +- **IDE integration**: works with Visual Studio and `dotnet watch` for a seamless development experience + +## Documentation + +For comprehensive documentation, see . + +## Feedback & contributing + +Microsoft.Testing.Platform is an open source project. Provide feedback or report issues in the [microsoft/testfx](https://github.com/microsoft/testfx/issues) GitHub repository. diff --git a/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md index 866192516c..65ab2df081 100644 --- a/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md @@ -1,9 +1,28 @@ -# Microsoft.Testing +# Microsoft.Testing.Extensions.OpenTelemetry -Microsoft Testing is a set of platform, framework and protocol intended to make it possible to run any test on any target or device. +Microsoft.Testing.Extensions.OpenTelemetry is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that exports test telemetry data using the [OpenTelemetry](https://opentelemetry.io/) standard. -Documentation can be found at . +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.OpenTelemetry` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry) GitHub repository. + +## Install the package + +```dotnetcli +dotnet add package Microsoft.Testing.Extensions.OpenTelemetry +``` ## About -This package provides Open Telemetry extension to Microsoft Testing Platform. +This package extends Microsoft.Testing.Platform with: + +- **OpenTelemetry exporter**: exports test execution data (traces, metrics) using the OpenTelemetry protocol (OTLP) +- **Observability**: integrate test execution data into your existing observability stack (e.g. Jaeger, Prometheus, Grafana) +- **Standards-based**: leverages the OpenTelemetry .NET SDK for broad compatibility with telemetry backends +- **Your data, your infrastructure**: telemetry data is sent exclusively to the OTLP endpoint you configure — no data is sent to Microsoft + +## Documentation + +For comprehensive documentation, see . + +## Feedback & contributing + +Microsoft.Testing.Platform is an open source project. Provide feedback or report issues in the [microsoft/testfx](https://github.com/microsoft/testfx/issues) GitHub repository. diff --git a/src/Platform/Microsoft.Testing.Extensions.Retry/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.Retry/PACKAGE.md index 1d728ad78d..4b51bbe3a2 100644 --- a/src/Platform/Microsoft.Testing.Extensions.Retry/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.Retry/PACKAGE.md @@ -1,9 +1,29 @@ -# Microsoft.Testing +# Microsoft.Testing.Extensions.Retry -Microsoft Testing is a set of platform, framework and protocol intended to make it possible to run any test on any target or device. +Microsoft.Testing.Extensions.Retry is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that provides a retry mechanism for failed tests, helping identify and manage flaky tests. -Documentation can be found at . +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.Retry` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.Retry) GitHub repository. + +## Install the package + +```dotnetcli +dotnet add package Microsoft.Testing.Extensions.Retry +``` ## About -This package extends Microsoft Testing Platform to provide a retry policy system that allows to restart tests on failure. +This package extends Microsoft.Testing.Platform with: + +- **Automatic retry**: automatically re-runs failed tests up to a configurable number of times +- **Flaky test management**: helps distinguish between genuinely failing tests and intermittently flaky tests +- **CI resilience**: improves reliability of CI pipelines by reducing false failures caused by transient issues + +Enable retry via the `--retry-failed-tests` command line option, and configure the maximum number of retries with `--retry-failed-tests-max-count`. + +## Documentation + +For comprehensive documentation, see . + +## Feedback & contributing + +Microsoft.Testing.Platform is an open source project. Provide feedback or report issues in the [microsoft/testfx](https://github.com/microsoft/testfx/issues) GitHub repository. diff --git a/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md index 46232617ad..193fa9a810 100644 --- a/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md @@ -1,9 +1,29 @@ -# Microsoft.Testing +# Microsoft.Testing.Extensions.Telemetry -Microsoft Testing is a set of platform, framework and protocol intended to make it possible to run any test on any target or device. +Microsoft.Testing.Extensions.Telemetry is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that collects usage telemetry to help the Microsoft.Testing.Platform team improve the product. -Documentation can be found at . +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.Telemetry` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.Telemetry) GitHub repository. + +## Install the package + +```dotnetcli +dotnet add package Microsoft.Testing.Extensions.Telemetry +``` ## About -This package provides telemetry extensions to Microsoft Testing Platform. +This package extends Microsoft.Testing.Platform with: + +- **Usage telemetry**: collects anonymous usage data to help the Microsoft.Testing.Platform team understand how the platform is used +- **Opt-out support**: telemetry can be disabled via the `DOTNET_CLI_TELEMETRY_OPTOUT` environment variable or the `--no-telemetry` command line option +- **Privacy-first**: no personally identifiable information (PII) is collected + +This package is typically **not referenced directly**. Instead, test framework packages (such as [MSTest](https://www.nuget.org/packages/MSTest)) reference it automatically. + +## Documentation + +For comprehensive documentation, see . + +## Feedback & contributing + +Microsoft.Testing.Platform is an open source project. Provide feedback or report issues in the [microsoft/testfx](https://github.com/microsoft/testfx/issues) GitHub repository. diff --git a/src/Platform/Microsoft.Testing.Extensions.TrxReport.Abstractions/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.TrxReport.Abstractions/PACKAGE.md index 19953e6fef..b731fb2cfd 100644 --- a/src/Platform/Microsoft.Testing.Extensions.TrxReport.Abstractions/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.TrxReport.Abstractions/PACKAGE.md @@ -1,11 +1,32 @@ -# Microsoft.Testing +# Microsoft.Testing.Extensions.TrxReport.Abstractions -Microsoft Testing is a set of platform, framework and protocol intended to make it possible to run any test on any target or device. +Microsoft.Testing.Extensions.TrxReport.Abstractions provides the interfaces and data objects for extensions that need to interoperate with TRX report functionality in [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform). -Documentation can be found at . +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.TrxReport.Abstractions` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.TrxReport.Abstractions) GitHub repository. + +## Install the package + +```dotnetcli +dotnet add package Microsoft.Testing.Extensions.TrxReport.Abstractions +``` ## About -This package provides interfaces and data objects used by extensions willing to interoperate with TRX functionality. +This package provides: + +- **TRX abstractions**: interfaces and data types for extensions that need to contribute to or consume TRX report data +- **Extensibility**: allows third-party extensions to enrich TRX reports with additional information + +> **Note**: This package provides only the abstractions. To generate TRX reports, install [Microsoft.Testing.Extensions.TrxReport](https://www.nuget.org/packages/Microsoft.Testing.Extensions.TrxReport). + +## Related packages + +- [Microsoft.Testing.Extensions.TrxReport](https://www.nuget.org/packages/Microsoft.Testing.Extensions.TrxReport): TRX report generation extension + +## Documentation + +For comprehensive documentation, see . + +## Feedback & contributing -This package does not bring support for telemetry, for this you would need to install Microsoft.Testing.Extensions.TrxReport package. +Microsoft.Testing.Platform is an open source project. Provide feedback or report issues in the [microsoft/testfx](https://github.com/microsoft/testfx/issues) GitHub repository. diff --git a/src/Platform/Microsoft.Testing.Extensions.TrxReport/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.TrxReport/PACKAGE.md index 69685e9b2b..b203482a4e 100644 --- a/src/Platform/Microsoft.Testing.Extensions.TrxReport/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.TrxReport/PACKAGE.md @@ -1,9 +1,34 @@ -# Microsoft.Testing +# Microsoft.Testing.Extensions.TrxReport -Microsoft Testing is a set of platform, framework and protocol intended to make it possible to run any test on any target or device. +Microsoft.Testing.Extensions.TrxReport is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that generates TRX (Visual Studio Test Results) report files. -Documentation can be found at . +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.TrxReport` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.TrxReport) GitHub repository. + +## Install the package + +```dotnetcli +dotnet add package Microsoft.Testing.Extensions.TrxReport +``` ## About -This package extends Microsoft Testing Platform to provide TRX test reports. +This package extends Microsoft.Testing.Platform with: + +- **TRX report generation**: produces `.trx` report files compatible with Visual Studio and Azure DevOps +- **Standardized format**: TRX is a widely supported XML-based test results format +- **CI integration**: TRX files can be published to Azure DevOps, GitHub Actions and other CI systems for rich test result visualization + +Enable TRX report generation via the `--report-trx` command line option. + +## Related packages + +- [Microsoft.Testing.Extensions.TrxReport.Abstractions](https://www.nuget.org/packages/Microsoft.Testing.Extensions.TrxReport.Abstractions): interfaces for extensions interoperating with TRX reports +- [Microsoft.Testing.Extensions.AzureDevOpsReport](https://www.nuget.org/packages/Microsoft.Testing.Extensions.AzureDevOpsReport): real-time test reporting for Azure DevOps Pipelines + +## Documentation + +For comprehensive documentation, see . + +## Feedback & contributing + +Microsoft.Testing.Platform is an open source project. Provide feedback or report issues in the [microsoft/testfx](https://github.com/microsoft/testfx/issues) GitHub repository. diff --git a/src/Platform/Microsoft.Testing.Extensions.VSTestBridge/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.VSTestBridge/PACKAGE.md index e11b0ee9a9..399718a71c 100644 --- a/src/Platform/Microsoft.Testing.Extensions.VSTestBridge/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.VSTestBridge/PACKAGE.md @@ -1,9 +1,29 @@ -# Microsoft.Testing +# Microsoft.Testing.Extensions.VSTestBridge -Microsoft Testing is a set of platform, framework and protocol intended to make it possible to run any test on any target or device. +Microsoft.Testing.Extensions.VSTestBridge is a **test framework author** extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform). It provides a compatibility bridge that allows existing VSTest test adapters to run on Microsoft.Testing.Platform without a full rewrite. -Documentation can be found at . +> **Note**: This package is **not intended for end-user test projects**. It is designed for test framework authors who are building or maintaining test adapters and want to support both VSTest and Microsoft.Testing.Platform. + +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.VSTestBridge` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.VSTestBridge) GitHub repository. + +## Install the package + +```dotnetcli +dotnet add package Microsoft.Testing.Extensions.VSTestBridge +``` ## About -This package provides bridge extensions to Microsoft Testing Platform to help test framework authors support both Test Anywhere and the old VSTest Test Platform. +This package provides: + +- **VSTest compatibility**: allows existing VSTest test adapters to run on Microsoft.Testing.Platform with minimal changes +- **Migration path**: enables test framework authors to gradually adopt Microsoft.Testing.Platform while maintaining backward compatibility with VSTest +- **Dual-targeting**: test frameworks can support both Microsoft.Testing.Platform and VSTest from a single codebase + +## Documentation + +For comprehensive documentation, see . + +## Feedback & contributing + +Microsoft.Testing.Platform is an open source project. Provide feedback or report issues in the [microsoft/testfx](https://github.com/microsoft/testfx/issues) GitHub repository. diff --git a/src/Platform/Microsoft.Testing.Platform.AI/PACKAGE.md b/src/Platform/Microsoft.Testing.Platform.AI/PACKAGE.md new file mode 100644 index 0000000000..784f0a1bc7 --- /dev/null +++ b/src/Platform/Microsoft.Testing.Platform.AI/PACKAGE.md @@ -0,0 +1,33 @@ +# Microsoft.Testing.Platform.AI + +Microsoft.Testing.Platform.AI provides the AI extensibility abstractions for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform), enabling test frameworks and extensions to leverage Large Language Models (LLMs) and AI capabilities for intelligent testing activities. + +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Platform.AI` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Platform.AI) GitHub repository. + +## Install the package + +```dotnetcli +dotnet add package Microsoft.Testing.Platform.AI +``` + +## About + +This package provides: + +- **IChatClientProvider abstraction**: a standardized interface for AI providers to integrate with the testing platform +- **Unified AI access**: allows any extension (crash dump analysis, hang analysis, test failure root cause analysis, etc.) to access AI capabilities without implementing provider-specific logic +- **Microsoft.Extensions.AI integration**: leverages the industry-standard [Microsoft.Extensions.AI](https://www.nuget.org/packages/Microsoft.Extensions.AI) abstractions for broad AI provider compatibility + +> **Note**: This package provides the abstractions only. You need an AI provider implementation (such as [Microsoft.Testing.Extensions.AzureFoundry](https://www.nuget.org/packages/Microsoft.Testing.Extensions.AzureFoundry)) to supply the actual AI capabilities. + +## Related packages + +- [Microsoft.Testing.Extensions.AzureFoundry](https://www.nuget.org/packages/Microsoft.Testing.Extensions.AzureFoundry): Azure AI Foundry (Azure OpenAI) provider implementation + +## Documentation + +For comprehensive documentation, see . + +## Feedback & contributing + +Microsoft.Testing.Platform is an open source project. Provide feedback or report issues in the [microsoft/testfx](https://github.com/microsoft/testfx/issues) GitHub repository. diff --git a/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md b/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md index 145cfef903..ab66567338 100644 --- a/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md @@ -1,9 +1,28 @@ -# Microsoft.Testing +# Microsoft.Testing.Platform.MSBuild -Microsoft Testing is a set of platform, framework and protocol intended to make it possible to run any test on any target or device. +Microsoft.Testing.Platform.MSBuild provides the MSBuild integration for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform). It enables `dotnet test`, Visual Studio Test Explorer and CI pipelines to discover and run tests built with Microsoft.Testing.Platform. -Documentation can be found at . +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Platform.MSBuild` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Platform.MSBuild) GitHub repository. + +## Install the package + +```dotnetcli +dotnet add package Microsoft.Testing.Platform.MSBuild +``` ## About -This package provides MSBuild integration for Microsoft Testing Platform. +This package provides: + +- **MSBuild integration**: generates the required build assets so that `dotnet test` can discover and run Microsoft.Testing.Platform-based tests +- **Configuration file support**: enables auto-generation of `.testingplatformconfig.json` configuration files + +This package is typically **not referenced directly**. Instead, test framework packages (such as [MSTest](https://www.nuget.org/packages/MSTest)) reference it automatically. + +## Documentation + +For comprehensive documentation, see . + +## Feedback & contributing + +Microsoft.Testing.Platform is an open source project. Provide feedback or report issues in the [microsoft/testfx](https://github.com/microsoft/testfx/issues) GitHub repository. diff --git a/src/Platform/Microsoft.Testing.Platform/PACKAGE.md b/src/Platform/Microsoft.Testing.Platform/PACKAGE.md index 76fe07c7eb..7157e0ca01 100644 --- a/src/Platform/Microsoft.Testing.Platform/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Platform/PACKAGE.md @@ -1,9 +1,33 @@ -# Microsoft.Testing +# Microsoft.Testing.Platform -Microsoft Testing is a set of platform, framework and protocol intended to make it possible to run any test on any target or device. +Microsoft.Testing.Platform is a lightweight and portable alternative to [VSTest](https://github.com/microsoft/vstest) for running tests in command line, in continuous integration (CI) pipelines, in Visual Studio Test Explorer, and in Visual Studio Code. The Microsoft.Testing.Platform is embedded directly in your test projects, and there is no dependency on `vstest.console` or `dotnet test` for running your tests. -Documentation can be found at . +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Platform` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Platform) GitHub repository. + +## Install the package + +```dotnetcli +dotnet add package Microsoft.Testing.Platform +``` ## About -This package provides the test platform. +This package provides the core platform and the .NET implementation of the testing protocol. It includes: + +- **Test host**: an in-process test runner that is embedded in your test project +- **Extensibility model**: a rich extensibility model allowing test frameworks, tools and extensions to interoperate +- **Protocol**: the `.NET Testing Protocol` enabling communication between the test host and external consumers (e.g. IDE, CI) + +This package is typically **not referenced directly**. Instead, test framework packages (such as [MSTest](https://www.nuget.org/packages/MSTest)) reference it automatically. + +## Related packages + +- [Microsoft.Testing.Platform.MSBuild](https://www.nuget.org/packages/Microsoft.Testing.Platform.MSBuild): MSBuild integration for `dotnet test` and CI pipeline support + +## Documentation + +For comprehensive documentation, see . + +## Feedback & contributing + +Microsoft.Testing.Platform is an open source project. Provide feedback or report issues in the [microsoft/testfx](https://github.com/microsoft/testfx/issues) GitHub repository. From 5b2fe712e01fd11dd26f355049662ae1d4e5b4c4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Amaury=20Lev=C3=A9?= Date: Sun, 22 Feb 2026 13:56:58 +0100 Subject: [PATCH 2/8] Update src/Platform/Microsoft.Testing.Platform/PACKAGE.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- src/Platform/Microsoft.Testing.Platform/PACKAGE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/Platform/Microsoft.Testing.Platform/PACKAGE.md b/src/Platform/Microsoft.Testing.Platform/PACKAGE.md index 7157e0ca01..6ca984dcf7 100644 --- a/src/Platform/Microsoft.Testing.Platform/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Platform/PACKAGE.md @@ -1,6 +1,6 @@ # Microsoft.Testing.Platform -Microsoft.Testing.Platform is a lightweight and portable alternative to [VSTest](https://github.com/microsoft/vstest) for running tests in command line, in continuous integration (CI) pipelines, in Visual Studio Test Explorer, and in Visual Studio Code. The Microsoft.Testing.Platform is embedded directly in your test projects, and there is no dependency on `vstest.console` or `dotnet test` for running your tests. +Microsoft.Testing.Platform is a lightweight and portable alternative to [VSTest](https://github.com/microsoft/vstest) for running tests in command line, in continuous integration (CI) pipelines, in Visual Studio Test Explorer, and in Visual Studio Code. Microsoft.Testing.Platform is embedded directly in your test projects, and there is no dependency on `vstest.console` or `dotnet test` for running your tests. Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Platform` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Platform) GitHub repository. From e97d6028bb4c119cb0b08290d568b134ea491f39 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Amaury=20Lev=C3=A9?= Date: Sun, 22 Feb 2026 14:15:00 +0100 Subject: [PATCH 3/8] Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- src/Platform/Microsoft.Testing.Extensions.Retry/PACKAGE.md | 2 +- src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md | 2 +- src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/src/Platform/Microsoft.Testing.Extensions.Retry/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.Retry/PACKAGE.md index 4b51bbe3a2..94aeeda5a7 100644 --- a/src/Platform/Microsoft.Testing.Extensions.Retry/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.Retry/PACKAGE.md @@ -18,7 +18,7 @@ This package extends Microsoft.Testing.Platform with: - **Flaky test management**: helps distinguish between genuinely failing tests and intermittently flaky tests - **CI resilience**: improves reliability of CI pipelines by reducing false failures caused by transient issues -Enable retry via the `--retry-failed-tests` command line option, and configure the maximum number of retries with `--retry-failed-tests-max-count`. +Configure retry using `--retry-failed-tests `, and optionally limit retries with `--retry-failed-tests-max-percentage` or `--retry-failed-tests-max-tests`. ## Documentation diff --git a/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md index 193fa9a810..49fbf0efcc 100644 --- a/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md @@ -15,7 +15,7 @@ dotnet add package Microsoft.Testing.Extensions.Telemetry This package extends Microsoft.Testing.Platform with: - **Usage telemetry**: collects anonymous usage data to help the Microsoft.Testing.Platform team understand how the platform is used -- **Opt-out support**: telemetry can be disabled via the `DOTNET_CLI_TELEMETRY_OPTOUT` environment variable or the `--no-telemetry` command line option +- **Opt-out support**: telemetry can be disabled via the `TESTINGPLATFORM_TELEMETRY_OPTOUT` or `DOTNET_CLI_TELEMETRY_OPTOUT` environment variables - **Privacy-first**: no personally identifiable information (PII) is collected This package is typically **not referenced directly**. Instead, test framework packages (such as [MSTest](https://www.nuget.org/packages/MSTest)) reference it automatically. diff --git a/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md b/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md index ab66567338..da4a95b1a2 100644 --- a/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md @@ -15,7 +15,7 @@ dotnet add package Microsoft.Testing.Platform.MSBuild This package provides: - **MSBuild integration**: generates the required build assets so that `dotnet test` can discover and run Microsoft.Testing.Platform-based tests -- **Configuration file support**: enables auto-generation of `.testingplatformconfig.json` configuration files +- **Configuration file support**: copies `testconfig.json` from the project into the output directory as `$(AssemblyName).testconfig.json` This package is typically **not referenced directly**. Instead, test framework packages (such as [MSTest](https://www.nuget.org/packages/MSTest)) reference it automatically. From d284fb7abac43e7b0c5017fe77d4be5e837288dd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Amaury=20Lev=C3=A9?= Date: Tue, 24 Feb 2026 10:01:47 +0100 Subject: [PATCH 4/8] Update readmes --- .../PACKAGE.md | 12 ++++++++---- .../PACKAGE.md | 6 ++++-- .../PACKAGE.md | 4 +++- .../Microsoft.Testing.Extensions.HangDump/PACKAGE.md | 4 ++++ .../PACKAGE.md | 6 +++++- .../PACKAGE.md | 3 ++- .../Microsoft.Testing.Extensions.Retry/PACKAGE.md | 8 +++++--- .../PACKAGE.md | 6 ++++-- .../PACKAGE.md | 4 ++++ .../PACKAGE.md | 4 +++- .../PACKAGE.md | 12 +++++++----- .../Microsoft.Testing.Platform.AI/PACKAGE.md | 4 +++- .../Microsoft.Testing.Platform.MSBuild/PACKAGE.md | 6 ++++-- src/Platform/Microsoft.Testing.Platform/PACKAGE.md | 6 ++++-- 14 files changed, 60 insertions(+), 25 deletions(-) diff --git a/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport/PACKAGE.md index e64cc92b3a..6d2a3ad1ea 100644 --- a/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport/PACKAGE.md @@ -1,6 +1,6 @@ # Microsoft.Testing.Extensions.AzureDevOpsReport -Microsoft.Testing.Extensions.AzureDevOpsReport is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that provides real-time test result reporting for Azure DevOps Pipelines. +Microsoft.Testing.Extensions.AzureDevOpsReport is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that reports test failures and warnings in Azure DevOps CI builds, with file/line annotations when available. Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.AzureDevOpsReport` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport) GitHub repository. @@ -14,9 +14,11 @@ dotnet add package Microsoft.Testing.Extensions.AzureDevOpsReport This package extends Microsoft.Testing.Platform with: -- **Real-time test reporting**: reports individual test results to Azure DevOps as they complete -- **Pipeline integration**: automatically detects Azure DevOps Pipelines environments -- **Test run summaries**: provides rich test result summaries visible in the Azure DevOps Pipeline UI +- **Azure DevOps reporting**: emits CI errors/warnings for test failures via the Azure DevOps logging commands +- **Configurable severity**: supports `--report-azdo-severity` (`error` or `warning`) +- **CI auto-detection**: detects Azure DevOps environments through the `TF_BUILD` variable + +Enable Azure DevOps reporting with the `--report-azdo` command line option. ## Related packages @@ -24,6 +26,8 @@ This package extends Microsoft.Testing.Platform with: ## Documentation +For this extension, see . + For comprehensive documentation, see . ## Feedback & contributing diff --git a/src/Platform/Microsoft.Testing.Extensions.AzureFoundry/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.AzureFoundry/PACKAGE.md index 4f07268e13..624c2e0f73 100644 --- a/src/Platform/Microsoft.Testing.Extensions.AzureFoundry/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.AzureFoundry/PACKAGE.md @@ -15,8 +15,8 @@ dotnet add package Microsoft.Testing.Extensions.AzureFoundry This package extends Microsoft.Testing.Platform with: - **Azure AI Foundry integration**: provides an `IChatClientProvider` implementation backed by Azure OpenAI -- **AI-powered test analysis**: enables extensions to leverage LLMs for intelligent testing activities such as crash dump analysis, hang analysis, flaky test detection and test failure root cause analysis -- **Automatic configuration**: discovers Azure AI settings from environment variables for seamless CI integration +- **Provider implementation**: supplies chat client capabilities to extensions using `Microsoft.Testing.Platform.AI` +- **Environment-based configuration**: reads Azure OpenAI settings from environment variables This package is a reference implementation of the [Microsoft.Testing.Platform.AI](https://www.nuget.org/packages/Microsoft.Testing.Platform.AI) abstractions. @@ -26,6 +26,8 @@ This package is a reference implementation of the [Microsoft.Testing.Platform.AI ## Documentation +For this extension, see . + For comprehensive documentation, see . ## Feedback & contributing diff --git a/src/Platform/Microsoft.Testing.Extensions.CrashDump/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.CrashDump/PACKAGE.md index ad90ce2e35..6e62348c4b 100644 --- a/src/Platform/Microsoft.Testing.Extensions.CrashDump/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.CrashDump/PACKAGE.md @@ -16,7 +16,7 @@ This package extends Microsoft.Testing.Platform with: - **Crash dump collection**: automatically captures a memory dump when the test process crashes - **Post-mortem debugging**: collected dumps can be analyzed with tools like Visual Studio, WinDbg, or `dotnet-dump` -- **CI-friendly**: crash dumps are saved to the test results directory for easy retrieval in CI pipelines +- **Runtime behavior**: supported for .NET 6+; on .NET Framework this extension is ignored Enable crash dump collection via the `--crashdump` command line option. @@ -26,6 +26,8 @@ Enable crash dump collection via the `--crashdump` command line option. ## Documentation +For this extension, see . + For comprehensive documentation, see . ## Feedback & contributing diff --git a/src/Platform/Microsoft.Testing.Extensions.HangDump/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.HangDump/PACKAGE.md index 2f102eb6d3..131615fb48 100644 --- a/src/Platform/Microsoft.Testing.Extensions.HangDump/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.HangDump/PACKAGE.md @@ -18,6 +18,8 @@ This package extends Microsoft.Testing.Platform with: - **Dump collection**: captures a memory dump of the hanging process for post-mortem analysis - **Deadlock investigation**: collected dumps can be analyzed with tools like Visual Studio, WinDbg, or `dotnet-dump` to diagnose deadlocks and other hang causes +The timeout defaults to `30m` and can be configured in values such as `90s`, `5m`, or `1.5h`. + Enable hang dump collection via the `--hangdump` command line option, and configure the timeout with `--hangdump-timeout`. ## Related packages @@ -26,6 +28,8 @@ Enable hang dump collection via the `--hangdump` command line option, and config ## Documentation +For this extension, see . + For comprehensive documentation, see . ## Feedback & contributing diff --git a/src/Platform/Microsoft.Testing.Extensions.HotReload/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.HotReload/PACKAGE.md index 7854bc024e..627b00989b 100644 --- a/src/Platform/Microsoft.Testing.Extensions.HotReload/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.HotReload/PACKAGE.md @@ -16,10 +16,14 @@ This package extends Microsoft.Testing.Platform with: - **Hot Reload integration**: apply code changes to your test project without restarting the test host - **Faster inner loop**: reduces the time between making a change and seeing the test results -- **IDE integration**: works with Visual Studio and `dotnet watch` for a seamless development experience +- **Console-mode support**: currently supported in console mode (not in Visual Studio/VS Code Test Explorer) + +Enable Hot Reload support by setting `TESTINGPLATFORM_HOTRELOAD_ENABLED=1`. ## Documentation +For this extension, see . + For comprehensive documentation, see . ## Feedback & contributing diff --git a/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md index 65ab2df081..d317316887 100644 --- a/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md @@ -17,10 +17,11 @@ This package extends Microsoft.Testing.Platform with: - **OpenTelemetry exporter**: exports test execution data (traces, metrics) using the OpenTelemetry protocol (OTLP) - **Observability**: integrate test execution data into your existing observability stack (e.g. Jaeger, Prometheus, Grafana) - **Standards-based**: leverages the OpenTelemetry .NET SDK for broad compatibility with telemetry backends -- **Your data, your infrastructure**: telemetry data is sent exclusively to the OTLP endpoint you configure — no data is sent to Microsoft ## Documentation +For this extension, see . + For comprehensive documentation, see . ## Feedback & contributing diff --git a/src/Platform/Microsoft.Testing.Extensions.Retry/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.Retry/PACKAGE.md index 94aeeda5a7..c1d4af4f6a 100644 --- a/src/Platform/Microsoft.Testing.Extensions.Retry/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.Retry/PACKAGE.md @@ -1,6 +1,6 @@ # Microsoft.Testing.Extensions.Retry -Microsoft.Testing.Extensions.Retry is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that provides a retry mechanism for failed tests, helping identify and manage flaky tests. +Microsoft.Testing.Extensions.Retry is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that provides test resilience and transient-fault handling by rerunning failed tests. Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.Retry` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.Retry) GitHub repository. @@ -15,13 +15,15 @@ dotnet add package Microsoft.Testing.Extensions.Retry This package extends Microsoft.Testing.Platform with: - **Automatic retry**: automatically re-runs failed tests up to a configurable number of times -- **Flaky test management**: helps distinguish between genuinely failing tests and intermittently flaky tests -- **CI resilience**: improves reliability of CI pipelines by reducing false failures caused by transient issues +- **Retry guards**: can stop retries when failure thresholds are exceeded (`--retry-failed-tests-max-percentage`, `--retry-failed-tests-max-tests`) +- **Integration-test focus**: intended for scenarios where transient environment issues can cause intermittent failures Configure retry using `--retry-failed-tests `, and optionally limit retries with `--retry-failed-tests-max-percentage` or `--retry-failed-tests-max-tests`. ## Documentation +For this extension, see . + For comprehensive documentation, see . ## Feedback & contributing diff --git a/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md index 49fbf0efcc..58ad7654a8 100644 --- a/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md @@ -14,14 +14,16 @@ dotnet add package Microsoft.Testing.Extensions.Telemetry This package extends Microsoft.Testing.Platform with: -- **Usage telemetry**: collects anonymous usage data to help the Microsoft.Testing.Platform team understand how the platform is used +- **Usage telemetry**: collects usage data to help understand product usage and prioritize improvements - **Opt-out support**: telemetry can be disabled via the `TESTINGPLATFORM_TELEMETRY_OPTOUT` or `DOTNET_CLI_TELEMETRY_OPTOUT` environment variables -- **Privacy-first**: no personally identifiable information (PII) is collected +- **Disclosure**: telemetry information is shown on first run, with opt-out guidance This package is typically **not referenced directly**. Instead, test framework packages (such as [MSTest](https://www.nuget.org/packages/MSTest)) reference it automatically. ## Documentation +For this extension, see . + For comprehensive documentation, see . ## Feedback & contributing diff --git a/src/Platform/Microsoft.Testing.Extensions.TrxReport.Abstractions/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.TrxReport.Abstractions/PACKAGE.md index b731fb2cfd..130d3af111 100644 --- a/src/Platform/Microsoft.Testing.Extensions.TrxReport.Abstractions/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.TrxReport.Abstractions/PACKAGE.md @@ -18,6 +18,8 @@ This package provides: - **Extensibility**: allows third-party extensions to enrich TRX reports with additional information > **Note**: This package provides only the abstractions. To generate TRX reports, install [Microsoft.Testing.Extensions.TrxReport](https://www.nuget.org/packages/Microsoft.Testing.Extensions.TrxReport). +> +> For most test projects, you should install `Microsoft.Testing.Extensions.TrxReport` instead of referencing this package directly. ## Related packages @@ -25,6 +27,8 @@ This package provides: ## Documentation +For this extension, see . + For comprehensive documentation, see . ## Feedback & contributing diff --git a/src/Platform/Microsoft.Testing.Extensions.TrxReport/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.TrxReport/PACKAGE.md index b203482a4e..199f0cc340 100644 --- a/src/Platform/Microsoft.Testing.Extensions.TrxReport/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.TrxReport/PACKAGE.md @@ -23,10 +23,12 @@ Enable TRX report generation via the `--report-trx` command line option. ## Related packages - [Microsoft.Testing.Extensions.TrxReport.Abstractions](https://www.nuget.org/packages/Microsoft.Testing.Extensions.TrxReport.Abstractions): interfaces for extensions interoperating with TRX reports -- [Microsoft.Testing.Extensions.AzureDevOpsReport](https://www.nuget.org/packages/Microsoft.Testing.Extensions.AzureDevOpsReport): real-time test reporting for Azure DevOps Pipelines +- [Microsoft.Testing.Extensions.AzureDevOpsReport](https://www.nuget.org/packages/Microsoft.Testing.Extensions.AzureDevOpsReport): Azure DevOps CI error/warning reporting for test failures ## Documentation +For this extension, see . + For comprehensive documentation, see . ## Feedback & contributing diff --git a/src/Platform/Microsoft.Testing.Extensions.VSTestBridge/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.VSTestBridge/PACKAGE.md index 399718a71c..550a7ffc69 100644 --- a/src/Platform/Microsoft.Testing.Extensions.VSTestBridge/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.VSTestBridge/PACKAGE.md @@ -1,8 +1,8 @@ # Microsoft.Testing.Extensions.VSTestBridge -Microsoft.Testing.Extensions.VSTestBridge is a **test framework author** extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform). It provides a compatibility bridge that allows existing VSTest test adapters to run on Microsoft.Testing.Platform without a full rewrite. +Microsoft.Testing.Extensions.VSTestBridge is a **test framework author** extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform). It provides a compatibility layer with VSTest so frameworks can support Microsoft.Testing.Platform while continuing VSTest-mode workflows. -> **Note**: This package is **not intended for end-user test projects**. It is designed for test framework authors who are building or maintaining test adapters and want to support both VSTest and Microsoft.Testing.Platform. +> **Note**: This package is **not intended for end-user test projects**. It is designed for framework and adapter maintainers who need compatibility with both VSTest and Microsoft.Testing.Platform. Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.VSTestBridge` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.VSTestBridge) GitHub repository. @@ -16,12 +16,14 @@ dotnet add package Microsoft.Testing.Extensions.VSTestBridge This package provides: -- **VSTest compatibility**: allows existing VSTest test adapters to run on Microsoft.Testing.Platform with minimal changes -- **Migration path**: enables test framework authors to gradually adopt Microsoft.Testing.Platform while maintaining backward compatibility with VSTest -- **Dual-targeting**: test frameworks can support both Microsoft.Testing.Platform and VSTest from a single codebase +- **VSTest compatibility layer**: helps frameworks keep existing VSTest-mode workflows (`vstest.console.exe`, `dotnet test`, VSTest task, Test Explorer) +- **Migration path**: enables framework authors to gradually adopt Microsoft.Testing.Platform while maintaining compatibility +- **Runsettings and filter support**: enables VSTest `.runsettings`/`--filter` compatibility where supported by the framework ## Documentation +For this extension, see . + For comprehensive documentation, see . ## Feedback & contributing diff --git a/src/Platform/Microsoft.Testing.Platform.AI/PACKAGE.md b/src/Platform/Microsoft.Testing.Platform.AI/PACKAGE.md index 784f0a1bc7..fdb21a34b8 100644 --- a/src/Platform/Microsoft.Testing.Platform.AI/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Platform.AI/PACKAGE.md @@ -15,7 +15,7 @@ dotnet add package Microsoft.Testing.Platform.AI This package provides: - **IChatClientProvider abstraction**: a standardized interface for AI providers to integrate with the testing platform -- **Unified AI access**: allows any extension (crash dump analysis, hang analysis, test failure root cause analysis, etc.) to access AI capabilities without implementing provider-specific logic +- **Unified AI access**: allows extensions to consume AI capabilities without implementing provider-specific logic - **Microsoft.Extensions.AI integration**: leverages the industry-standard [Microsoft.Extensions.AI](https://www.nuget.org/packages/Microsoft.Extensions.AI) abstractions for broad AI provider compatibility > **Note**: This package provides the abstractions only. You need an AI provider implementation (such as [Microsoft.Testing.Extensions.AzureFoundry](https://www.nuget.org/packages/Microsoft.Testing.Extensions.AzureFoundry)) to supply the actual AI capabilities. @@ -26,6 +26,8 @@ This package provides: ## Documentation +For this package, see . + For comprehensive documentation, see . ## Feedback & contributing diff --git a/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md b/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md index da4a95b1a2..5b16267770 100644 --- a/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md @@ -1,6 +1,6 @@ # Microsoft.Testing.Platform.MSBuild -Microsoft.Testing.Platform.MSBuild provides the MSBuild integration for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform). It enables `dotnet test`, Visual Studio Test Explorer and CI pipelines to discover and run tests built with Microsoft.Testing.Platform. +Microsoft.Testing.Platform.MSBuild provides the MSBuild integration for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform), including build assets for platform extensions and test configuration files. Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Platform.MSBuild` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Platform.MSBuild) GitHub repository. @@ -14,13 +14,15 @@ dotnet add package Microsoft.Testing.Platform.MSBuild This package provides: -- **MSBuild integration**: generates the required build assets so that `dotnet test` can discover and run Microsoft.Testing.Platform-based tests +- **MSBuild integration**: generates the required build assets for Microsoft.Testing.Platform test projects - **Configuration file support**: copies `testconfig.json` from the project into the output directory as `$(AssemblyName).testconfig.json` This package is typically **not referenced directly**. Instead, test framework packages (such as [MSTest](https://www.nuget.org/packages/MSTest)) reference it automatically. ## Documentation +For this package, see . + For comprehensive documentation, see . ## Feedback & contributing diff --git a/src/Platform/Microsoft.Testing.Platform/PACKAGE.md b/src/Platform/Microsoft.Testing.Platform/PACKAGE.md index 6ca984dcf7..58dbee98da 100644 --- a/src/Platform/Microsoft.Testing.Platform/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Platform/PACKAGE.md @@ -1,6 +1,6 @@ # Microsoft.Testing.Platform -Microsoft.Testing.Platform is a lightweight and portable alternative to [VSTest](https://github.com/microsoft/vstest) for running tests in command line, in continuous integration (CI) pipelines, in Visual Studio Test Explorer, and in Visual Studio Code. Microsoft.Testing.Platform is embedded directly in your test projects, and there is no dependency on `vstest.console` or `dotnet test` for running your tests. +Microsoft.Testing.Platform is a lightweight and portable alternative to [VSTest](https://github.com/microsoft/vstest) for running tests in CLI, continuous integration (CI) pipelines, Visual Studio Test Explorer, and Visual Studio Code Test Explorer. Microsoft.Testing.Platform is embedded directly in your test projects and test applications can be run directly. Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Platform` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Platform) GitHub repository. @@ -14,7 +14,7 @@ dotnet add package Microsoft.Testing.Platform This package provides the core platform and the .NET implementation of the testing protocol. It includes: -- **Test host**: an in-process test runner that is embedded in your test project +- **Test application host**: test projects are built as executables that can be run directly - **Extensibility model**: a rich extensibility model allowing test frameworks, tools and extensions to interoperate - **Protocol**: the `.NET Testing Protocol` enabling communication between the test host and external consumers (e.g. IDE, CI) @@ -26,6 +26,8 @@ This package is typically **not referenced directly**. Instead, test framework p ## Documentation +For this package, see . + For comprehensive documentation, see . ## Feedback & contributing From c13c5d025974c5ff7fba2306c3c116c2186a5e16 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Amaury=20Lev=C3=A9?= Date: Fri, 27 Feb 2026 19:01:30 +0100 Subject: [PATCH 5/8] Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Youssef Victor --- src/Platform/Microsoft.Testing.Extensions.HangDump/PACKAGE.md | 2 +- src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/Platform/Microsoft.Testing.Extensions.HangDump/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.HangDump/PACKAGE.md index 131615fb48..e2c77a87bd 100644 --- a/src/Platform/Microsoft.Testing.Extensions.HangDump/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.HangDump/PACKAGE.md @@ -14,7 +14,7 @@ dotnet add package Microsoft.Testing.Extensions.HangDump This package extends Microsoft.Testing.Platform with: -- **Hang detection**: monitors the test host process and detects when it exceeds a configurable timeout +- **Hang detection**: monitors the test host process and detects when it exceeds a configurable timeout without any activity. - **Dump collection**: captures a memory dump of the hanging process for post-mortem analysis - **Deadlock investigation**: collected dumps can be analyzed with tools like Visual Studio, WinDbg, or `dotnet-dump` to diagnose deadlocks and other hang causes diff --git a/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md index 58ad7654a8..a929f36a9f 100644 --- a/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md @@ -18,7 +18,7 @@ This package extends Microsoft.Testing.Platform with: - **Opt-out support**: telemetry can be disabled via the `TESTINGPLATFORM_TELEMETRY_OPTOUT` or `DOTNET_CLI_TELEMETRY_OPTOUT` environment variables - **Disclosure**: telemetry information is shown on first run, with opt-out guidance -This package is typically **not referenced directly**. Instead, test framework packages (such as [MSTest](https://www.nuget.org/packages/MSTest)) reference it automatically. +This package is an optional, opt-in extension. To enable telemetry when using Microsoft.Testing.Platform (including when running tests with [MSTest](https://www.nuget.org/packages/MSTest)), you must explicitly reference the `Microsoft.Testing.Extensions.Telemetry` package from your test project or from your own test framework or tooling package. ## Documentation From 27d2a06a752c00e0123a9f81d441e5bb91e1a7c1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Amaury=20Lev=C3=A9?= Date: Mon, 2 Mar 2026 13:57:25 +0100 Subject: [PATCH 6/8] Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- .../Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md index d317316887..a42742f64e 100644 --- a/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md @@ -14,9 +14,9 @@ dotnet add package Microsoft.Testing.Extensions.OpenTelemetry This package extends Microsoft.Testing.Platform with: -- **OpenTelemetry exporter**: exports test execution data (traces, metrics) using the OpenTelemetry protocol (OTLP) -- **Observability**: integrate test execution data into your existing observability stack (e.g. Jaeger, Prometheus, Grafana) -- **Standards-based**: leverages the OpenTelemetry .NET SDK for broad compatibility with telemetry backends +- **OpenTelemetry integration**: instruments test execution and produces OpenTelemetry-compatible traces and metrics that can be exported by user-configured exporters (for example, OTLP exporters) +- **Observability**: enables you to route test execution data, via your own OpenTelemetry exporter configuration, into observability backends (e.g. Jaeger, Prometheus, Grafana) +- **Standards-based**: leverages the OpenTelemetry .NET SDK so that data is sent only to the telemetry exporters and endpoints that you configure ## Documentation From f5def6dc35407e0e40254dc45428f66b4b2a2ef1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Amaury=20Lev=C3=A9?= Date: Mon, 2 Mar 2026 16:23:01 +0100 Subject: [PATCH 7/8] Address copilot comments --- .../PACKAGE.md | 4 ++-- .../Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md | 2 +- src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md | 5 +++-- 3 files changed, 6 insertions(+), 5 deletions(-) diff --git a/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport/PACKAGE.md index 6d2a3ad1ea..45387cc4d8 100644 --- a/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport/PACKAGE.md @@ -1,6 +1,6 @@ # Microsoft.Testing.Extensions.AzureDevOpsReport -Microsoft.Testing.Extensions.AzureDevOpsReport is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that reports test failures and warnings in Azure DevOps CI builds, with file/line annotations when available. +Microsoft.Testing.Extensions.AzureDevOpsReport is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that reports individual test failures as errors or warnings in Azure DevOps CI builds, with file/line annotations when available. Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.AzureDevOpsReport` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport) GitHub repository. @@ -14,7 +14,7 @@ dotnet add package Microsoft.Testing.Extensions.AzureDevOpsReport This package extends Microsoft.Testing.Platform with: -- **Azure DevOps reporting**: emits CI errors/warnings for test failures via the Azure DevOps logging commands +- **Azure DevOps reporting**: emits individual CI errors/warnings for each test failure via the Azure DevOps logging commands - **Configurable severity**: supports `--report-azdo-severity` (`error` or `warning`) - **CI auto-detection**: detects Azure DevOps environments through the `TF_BUILD` variable diff --git a/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md index a42742f64e..99498fc4b4 100644 --- a/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md @@ -1,6 +1,6 @@ # Microsoft.Testing.Extensions.OpenTelemetry -Microsoft.Testing.Extensions.OpenTelemetry is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that exports test telemetry data using the [OpenTelemetry](https://opentelemetry.io/) standard. +Microsoft.Testing.Extensions.OpenTelemetry is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that instruments test execution with [OpenTelemetry](https://opentelemetry.io/)-compatible traces and metrics. Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.OpenTelemetry` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry) GitHub repository. diff --git a/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md b/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md index 5b16267770..11270f79bc 100644 --- a/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md @@ -1,6 +1,6 @@ # Microsoft.Testing.Platform.MSBuild -Microsoft.Testing.Platform.MSBuild provides the MSBuild integration for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform), including build assets for platform extensions and test configuration files. +Microsoft.Testing.Platform.MSBuild provides the MSBuild integration for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform), including entry-point generation, test configuration file support, and compatibility with `dotnet test`. Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Platform.MSBuild` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Platform.MSBuild) GitHub repository. @@ -14,8 +14,9 @@ dotnet add package Microsoft.Testing.Platform.MSBuild This package provides: -- **MSBuild integration**: generates the required build assets for Microsoft.Testing.Platform test projects +- **Entry-point generation**: generates the required entry point for Microsoft.Testing.Platform test projects - **Configuration file support**: copies `testconfig.json` from the project into the output directory as `$(AssemblyName).testconfig.json` +- **`dotnet test` compatibility**: enables running MTP-based test projects through the VSTest-based `dotnet test` command on .NET 8/9 SDKs This package is typically **not referenced directly**. Instead, test framework packages (such as [MSTest](https://www.nuget.org/packages/MSTest)) reference it automatically. From 84dda2b12b07549259b560746b2532064756203f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Amaury=20Lev=C3=A9?= Date: Tue, 3 Mar 2026 15:31:09 +0100 Subject: [PATCH 8/8] Updates --- .../PACKAGE.md | 2 +- .../Microsoft.Testing.Extensions.AzureFoundry/PACKAGE.md | 4 +--- .../Microsoft.Testing.Extensions.CrashDump/PACKAGE.md | 5 +++-- .../Microsoft.Testing.Extensions.HangDump/PACKAGE.md | 4 ++-- .../Microsoft.Testing.Extensions.HotReload/PACKAGE.md | 4 ++-- .../Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md | 4 ++-- src/Platform/Microsoft.Testing.Extensions.Retry/PACKAGE.md | 4 ++-- .../Microsoft.Testing.Extensions.Telemetry/PACKAGE.md | 2 +- .../PACKAGE.md | 2 +- .../Microsoft.Testing.Extensions.TrxReport/PACKAGE.md | 4 ++-- .../Microsoft.Testing.Extensions.VSTestBridge/PACKAGE.md | 2 +- src/Platform/Microsoft.Testing.Platform.AI/PACKAGE.md | 4 +--- src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md | 6 +++--- src/Platform/Microsoft.Testing.Platform/PACKAGE.md | 4 ++-- 14 files changed, 24 insertions(+), 27 deletions(-) diff --git a/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport/PACKAGE.md index 45387cc4d8..a7f24e3859 100644 --- a/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport/PACKAGE.md @@ -2,7 +2,7 @@ Microsoft.Testing.Extensions.AzureDevOpsReport is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that reports individual test failures as errors or warnings in Azure DevOps CI builds, with file/line annotations when available. -Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.AzureDevOpsReport` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.AzureDevOpsReport) GitHub repository. +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.AzureDevOpsReport` code in the [microsoft/testfx](https://github.com/microsoft/testfx) GitHub repository. ## Install the package diff --git a/src/Platform/Microsoft.Testing.Extensions.AzureFoundry/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.AzureFoundry/PACKAGE.md index 624c2e0f73..f51a68f006 100644 --- a/src/Platform/Microsoft.Testing.Extensions.AzureFoundry/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.AzureFoundry/PACKAGE.md @@ -2,7 +2,7 @@ Microsoft.Testing.Extensions.AzureFoundry is an AI provider extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that integrates with Azure AI Foundry (Azure OpenAI) to enable AI-powered testing capabilities. -Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.AzureFoundry` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.AzureFoundry) GitHub repository. +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.AzureFoundry` code in the [microsoft/testfx](https://github.com/microsoft/testfx) GitHub repository. ## Install the package @@ -26,8 +26,6 @@ This package is a reference implementation of the [Microsoft.Testing.Platform.AI ## Documentation -For this extension, see . - For comprehensive documentation, see . ## Feedback & contributing diff --git a/src/Platform/Microsoft.Testing.Extensions.CrashDump/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.CrashDump/PACKAGE.md index 6e62348c4b..6edac3ba07 100644 --- a/src/Platform/Microsoft.Testing.Extensions.CrashDump/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.CrashDump/PACKAGE.md @@ -2,7 +2,7 @@ Microsoft.Testing.Extensions.CrashDump is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that captures a crash dump of the test host process when an unhandled exception or crash occurs. -Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.CrashDump` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.CrashDump) GitHub repository. +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.CrashDump` code in the [microsoft/testfx](https://github.com/microsoft/testfx) GitHub repository. ## Install the package @@ -16,6 +16,7 @@ This package extends Microsoft.Testing.Platform with: - **Crash dump collection**: automatically captures a memory dump when the test process crashes - **Post-mortem debugging**: collected dumps can be analyzed with tools like Visual Studio, WinDbg, or `dotnet-dump` +- **Cross-platform**: supported on Windows, Linux, and macOS. Note that dumps collected on macOS can only be analyzed on macOS - **Runtime behavior**: supported for .NET 6+; on .NET Framework this extension is ignored Enable crash dump collection via the `--crashdump` command line option. @@ -26,7 +27,7 @@ Enable crash dump collection via the `--crashdump` command line option. ## Documentation -For this extension, see . +For this extension, see . For comprehensive documentation, see . diff --git a/src/Platform/Microsoft.Testing.Extensions.HangDump/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.HangDump/PACKAGE.md index e2c77a87bd..1aba709ddc 100644 --- a/src/Platform/Microsoft.Testing.Extensions.HangDump/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.HangDump/PACKAGE.md @@ -2,7 +2,7 @@ Microsoft.Testing.Extensions.HangDump is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that captures a memory dump when the test host process appears to be hung (exceeds a configurable timeout). -Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.HangDump` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.HangDump) GitHub repository. +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.HangDump` code in the [microsoft/testfx](https://github.com/microsoft/testfx) GitHub repository. ## Install the package @@ -28,7 +28,7 @@ Enable hang dump collection via the `--hangdump` command line option, and config ## Documentation -For this extension, see . +For this extension, see . For comprehensive documentation, see . diff --git a/src/Platform/Microsoft.Testing.Extensions.HotReload/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.HotReload/PACKAGE.md index 627b00989b..b4d7b1df5b 100644 --- a/src/Platform/Microsoft.Testing.Extensions.HotReload/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.HotReload/PACKAGE.md @@ -2,7 +2,7 @@ Microsoft.Testing.Extensions.HotReload is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that enables Hot Reload support, allowing you to apply code changes to your running tests without restarting the test host process. -Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.HotReload` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.HotReload) GitHub repository. +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.HotReload` code in the [microsoft/testfx](https://github.com/microsoft/testfx) GitHub repository. ## Install the package @@ -22,7 +22,7 @@ Enable Hot Reload support by setting `TESTINGPLATFORM_HOTRELOAD_ENABLED=1`. ## Documentation -For this extension, see . +For this extension, see . For comprehensive documentation, see . diff --git a/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md index 99498fc4b4..f6ed6bb69a 100644 --- a/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry/PACKAGE.md @@ -2,7 +2,7 @@ Microsoft.Testing.Extensions.OpenTelemetry is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that instruments test execution with [OpenTelemetry](https://opentelemetry.io/)-compatible traces and metrics. -Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.OpenTelemetry` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.OpenTelemetry) GitHub repository. +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.OpenTelemetry` code in the [microsoft/testfx](https://github.com/microsoft/testfx) GitHub repository. ## Install the package @@ -20,7 +20,7 @@ This package extends Microsoft.Testing.Platform with: ## Documentation -For this extension, see . +For this extension, see . For comprehensive documentation, see . diff --git a/src/Platform/Microsoft.Testing.Extensions.Retry/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.Retry/PACKAGE.md index c1d4af4f6a..ac00f1458c 100644 --- a/src/Platform/Microsoft.Testing.Extensions.Retry/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.Retry/PACKAGE.md @@ -2,7 +2,7 @@ Microsoft.Testing.Extensions.Retry is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that provides test resilience and transient-fault handling by rerunning failed tests. -Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.Retry` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.Retry) GitHub repository. +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.Retry` code in the [microsoft/testfx](https://github.com/microsoft/testfx) GitHub repository. ## Install the package @@ -22,7 +22,7 @@ Configure retry using `--retry-failed-tests `, and optionally limit ret ## Documentation -For this extension, see . +For this extension, see . For comprehensive documentation, see . diff --git a/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md index a929f36a9f..c9016f7874 100644 --- a/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.Telemetry/PACKAGE.md @@ -2,7 +2,7 @@ Microsoft.Testing.Extensions.Telemetry is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that collects usage telemetry to help the Microsoft.Testing.Platform team improve the product. -Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.Telemetry` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.Telemetry) GitHub repository. +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.Telemetry` code in the [microsoft/testfx](https://github.com/microsoft/testfx) GitHub repository. ## Install the package diff --git a/src/Platform/Microsoft.Testing.Extensions.TrxReport.Abstractions/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.TrxReport.Abstractions/PACKAGE.md index 130d3af111..e46172cd91 100644 --- a/src/Platform/Microsoft.Testing.Extensions.TrxReport.Abstractions/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.TrxReport.Abstractions/PACKAGE.md @@ -2,7 +2,7 @@ Microsoft.Testing.Extensions.TrxReport.Abstractions provides the interfaces and data objects for extensions that need to interoperate with TRX report functionality in [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform). -Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.TrxReport.Abstractions` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.TrxReport.Abstractions) GitHub repository. +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.TrxReport.Abstractions` code in the [microsoft/testfx](https://github.com/microsoft/testfx) GitHub repository. ## Install the package diff --git a/src/Platform/Microsoft.Testing.Extensions.TrxReport/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.TrxReport/PACKAGE.md index 199f0cc340..25e4c90857 100644 --- a/src/Platform/Microsoft.Testing.Extensions.TrxReport/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.TrxReport/PACKAGE.md @@ -2,7 +2,7 @@ Microsoft.Testing.Extensions.TrxReport is an extension for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform) that generates TRX (Visual Studio Test Results) report files. -Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.TrxReport` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.TrxReport) GitHub repository. +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.TrxReport` code in the [microsoft/testfx](https://github.com/microsoft/testfx) GitHub repository. ## Install the package @@ -27,7 +27,7 @@ Enable TRX report generation via the `--report-trx` command line option. ## Documentation -For this extension, see . +For this extension, see . For comprehensive documentation, see . diff --git a/src/Platform/Microsoft.Testing.Extensions.VSTestBridge/PACKAGE.md b/src/Platform/Microsoft.Testing.Extensions.VSTestBridge/PACKAGE.md index 550a7ffc69..ff9bf58c1a 100644 --- a/src/Platform/Microsoft.Testing.Extensions.VSTestBridge/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Extensions.VSTestBridge/PACKAGE.md @@ -4,7 +4,7 @@ Microsoft.Testing.Extensions.VSTestBridge is a **test framework author** extensi > **Note**: This package is **not intended for end-user test projects**. It is designed for framework and adapter maintainers who need compatibility with both VSTest and Microsoft.Testing.Platform. -Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.VSTestBridge` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Extensions.VSTestBridge) GitHub repository. +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Extensions.VSTestBridge` code in the [microsoft/testfx](https://github.com/microsoft/testfx) GitHub repository. ## Install the package diff --git a/src/Platform/Microsoft.Testing.Platform.AI/PACKAGE.md b/src/Platform/Microsoft.Testing.Platform.AI/PACKAGE.md index fdb21a34b8..82b2bd8ec8 100644 --- a/src/Platform/Microsoft.Testing.Platform.AI/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Platform.AI/PACKAGE.md @@ -2,7 +2,7 @@ Microsoft.Testing.Platform.AI provides the AI extensibility abstractions for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform), enabling test frameworks and extensions to leverage Large Language Models (LLMs) and AI capabilities for intelligent testing activities. -Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Platform.AI` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Platform.AI) GitHub repository. +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Platform.AI` code in the [microsoft/testfx](https://github.com/microsoft/testfx) GitHub repository. ## Install the package @@ -26,8 +26,6 @@ This package provides: ## Documentation -For this package, see . - For comprehensive documentation, see . ## Feedback & contributing diff --git a/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md b/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md index 11270f79bc..740c88bd3c 100644 --- a/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Platform.MSBuild/PACKAGE.md @@ -1,8 +1,8 @@ # Microsoft.Testing.Platform.MSBuild -Microsoft.Testing.Platform.MSBuild provides the MSBuild integration for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform), including entry-point generation, test configuration file support, and compatibility with `dotnet test`. +Microsoft.Testing.Platform.MSBuild provides the MSBuild tasks needed for [Microsoft.Testing.Platform](https://www.nuget.org/packages/Microsoft.Testing.Platform), including entry-point generation and test configuration file support. -Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Platform.MSBuild` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Platform.MSBuild) GitHub repository. +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Platform.MSBuild` code in the [microsoft/testfx](https://github.com/microsoft/testfx) GitHub repository. ## Install the package @@ -16,7 +16,7 @@ This package provides: - **Entry-point generation**: generates the required entry point for Microsoft.Testing.Platform test projects - **Configuration file support**: copies `testconfig.json` from the project into the output directory as `$(AssemblyName).testconfig.json` -- **`dotnet test` compatibility**: enables running MTP-based test projects through the VSTest-based `dotnet test` command on .NET 8/9 SDKs +- **`dotnet test` compatibility**: enables running MTP-based test projects through the VSTest-based `dotnet test` command on .NET SDKs This package is typically **not referenced directly**. Instead, test framework packages (such as [MSTest](https://www.nuget.org/packages/MSTest)) reference it automatically. diff --git a/src/Platform/Microsoft.Testing.Platform/PACKAGE.md b/src/Platform/Microsoft.Testing.Platform/PACKAGE.md index 58dbee98da..5b39823b2b 100644 --- a/src/Platform/Microsoft.Testing.Platform/PACKAGE.md +++ b/src/Platform/Microsoft.Testing.Platform/PACKAGE.md @@ -2,7 +2,7 @@ Microsoft.Testing.Platform is a lightweight and portable alternative to [VSTest](https://github.com/microsoft/vstest) for running tests in CLI, continuous integration (CI) pipelines, Visual Studio Test Explorer, and Visual Studio Code Test Explorer. Microsoft.Testing.Platform is embedded directly in your test projects and test applications can be run directly. -Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Platform` code in the [microsoft/testfx](https://github.com/microsoft/testfx/tree/main/src/Platform/Microsoft.Testing.Platform) GitHub repository. +Microsoft.Testing.Platform is open source. You can find `Microsoft.Testing.Platform` code in the [microsoft/testfx](https://github.com/microsoft/testfx) GitHub repository. ## Install the package @@ -16,7 +16,7 @@ This package provides the core platform and the .NET implementation of the testi - **Test application host**: test projects are built as executables that can be run directly - **Extensibility model**: a rich extensibility model allowing test frameworks, tools and extensions to interoperate -- **Protocol**: the `.NET Testing Protocol` enabling communication between the test host and external consumers (e.g. IDE, CI) +- **Protocol**: the `Microsoft Testing Platform protocol` enabling communication between the test host and external consumers (e.g. IDE, CI) This package is typically **not referenced directly**. Instead, test framework packages (such as [MSTest](https://www.nuget.org/packages/MSTest)) reference it automatically.