From 28e2ba4baf0e729351da6f6dff8edc082d0bae3c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Amaury=20Lev=C3=A9?= Date: Tue, 16 Jun 2026 08:29:07 +0200 Subject: [PATCH 1/2] docs: update glossary - weekly full scan (2026-06-16) Add CtrfReport and --progress entries based on recent merged PRs. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/glossary.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/glossary.md b/docs/glossary.md index 09335dc5e2..72678b0eb9 100644 --- a/docs/glossary.md +++ b/docs/glossary.md @@ -50,6 +50,10 @@ A public enum in `Microsoft.VisualStudio.TestTools.UnitTesting` used with [Condi An MTP extension (`Microsoft.Testing.Extensions.CrashDump`) that automatically captures a process memory dump when the test host crashes. Useful for diagnosing unexpected process termination during test runs. +### CtrfReport + +An MTP extension (`Microsoft.Testing.Extensions.CtrfReport`) that generates a [CTRF](https://github.com/ctrf-io/ctrf) (Common Test Report Format) JSON report at the end of a test run. CTRF is a vendor-neutral open standard for structured test results, consumed by GitHub Actions test-summary tools, Slack/Teams notifiers, dashboards, and other CI tooling. Enable via `--report-ctrf`; override the output filename with `--report-ctrf-filename`. When using [MSTest.Sdk](#mstestsdk), opt in with `true`. Currently **experimental** — the CLI options and output format may change without notice. + ## D ### DelayBackoffType @@ -190,6 +194,18 @@ A sealed class (`Microsoft.VisualStudio.TestTools.UnitTesting.PlannedTest`, curr An MTP class (`Microsoft.Testing.Platform.Extensions.Messages.PropertyBag`) that holds a typed collection of `IProperty` instances attached to a [TestNode](#testnode). Extension authors populate a `PropertyBag` with properties such as `TimingProperty`, `TestFileLocationProperty`, and `TestMetadataProperty` to communicate rich metadata about a test to the platform and to other extensions. A `PropertyBag` enforces that at most one `TestNodeStateProperty` may be present at a time. +### --progress + +An MTP terminal-reporter command-line option that controls whether animated progress output is shown during a test run. Accepts three values: + +| Value | Behavior | +| --- | --- | +| `auto` (default) | Show progress unless the terminal cannot update in place (non-ANSI/simple terminal), or the session is a test-host controller, `--list-tests`, or server mode | +| `on` | Same as `auto` (a dedicated heartbeat renderer for non-cursor modes is tracked separately) | +| `off` | Suppress all progress output | + +Introduced in [PR #9145](https://github.com/microsoft/testfx/pull/9145) as a replacement for the former `--no-progress` flag. `--no-progress` continues to work as a deprecated alias that routes to `--progress off` and emits a one-per-process deprecation warning on stderr; `--progress` always wins when both are supplied. + ## R ### Retry From b3a9d0c725884d5897972c5ffff8e2cc6ccc12ac Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Amaury=20Lev=C3=A9?= Date: Tue, 16 Jun 2026 09:09:16 +0200 Subject: [PATCH 2/2] docs: reorder --progress glossary entry before PropertyBag Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/glossary.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/glossary.md b/docs/glossary.md index 72678b0eb9..70fa90def1 100644 --- a/docs/glossary.md +++ b/docs/glossary.md @@ -190,10 +190,6 @@ An MTP extension (`Microsoft.Testing.Extensions.OpenTelemetry`) that exports tes A sealed class (`Microsoft.VisualStudio.TestTools.UnitTesting.PlannedTest`, currently `[Experimental("MSTESTEXP")]`) that describes a test that has been discovered and passed the active filter for the current assembly, before execution begins. Exposes the test's `FullyQualifiedTestClassName`, `TestName`, `TestDisplayName`, `AssemblyPath`, `ManagedTypeName`, `ManagedMethodName`, source file location (`DeclaringFilePath`, `DeclaringLineNumber`), `TestCategories` (from `[TestCategory]`), and `TestProperties` (from `[TestProperty]`). Instances are accessed via `TestRun.Current.PlannedTests`. Data-driven tests whose rows are resolved only at execution time (non-serializable data, `TestDataSourceUnfoldingStrategy.Fold` set via `[TestMethod(UnfoldingStrategy = TestDataSourceUnfoldingStrategy.Fold)]`, `[DataSource]`) appear as a single `PlannedTest` entry rather than one per row. See also [TestRun](#testrun) and RFC 014 (`docs/RFCs/014-TestRun-Current-PlannedTests.md`). -### PropertyBag - -An MTP class (`Microsoft.Testing.Platform.Extensions.Messages.PropertyBag`) that holds a typed collection of `IProperty` instances attached to a [TestNode](#testnode). Extension authors populate a `PropertyBag` with properties such as `TimingProperty`, `TestFileLocationProperty`, and `TestMetadataProperty` to communicate rich metadata about a test to the platform and to other extensions. A `PropertyBag` enforces that at most one `TestNodeStateProperty` may be present at a time. - ### --progress An MTP terminal-reporter command-line option that controls whether animated progress output is shown during a test run. Accepts three values: @@ -206,6 +202,10 @@ An MTP terminal-reporter command-line option that controls whether animated prog Introduced in [PR #9145](https://github.com/microsoft/testfx/pull/9145) as a replacement for the former `--no-progress` flag. `--no-progress` continues to work as a deprecated alias that routes to `--progress off` and emits a one-per-process deprecation warning on stderr; `--progress` always wins when both are supplied. +### PropertyBag + +An MTP class (`Microsoft.Testing.Platform.Extensions.Messages.PropertyBag`) that holds a typed collection of `IProperty` instances attached to a [TestNode](#testnode). Extension authors populate a `PropertyBag` with properties such as `TimingProperty`, `TestFileLocationProperty`, and `TestMetadataProperty` to communicate rich metadata about a test to the platform and to other extensions. A `PropertyBag` enforces that at most one `TestNodeStateProperty` may be present at a time. + ## R ### Retry