Skip to content

Document Azure DevOps group limitations - #55325

Open
Evangelink wants to merge 4 commits into
mainfrom
dev/amauryleve/document-parallel-azdo-groups
Open

Document Azure DevOps group limitations#55325
Evangelink wants to merge 4 commits into
mainfrom
dev/amauryleve/document-parallel-azdo-groups

Conversation

@Evangelink

@Evangelink Evangelink commented Aug 6, 2026

Copy link
Copy Markdown
Member

Summary

  • document the --report-azdo-groups option introduced in MTP 2.4.0
  • explain how anonymous Azure DevOps group commands can be misnested when parallel assembly output interleaves
  • document that groups default to off and should be enabled only for a single assembly or serialized assembly execution

Validation

  • markdownlint-cli2 docs/core/testing/microsoft-testing-platform-test-reports.md
  • git diff --check

Internal previews

File Preview link
docs/core/testing/microsoft-testing-platform-test-reports.md docs/core/testing/microsoft-testing-platform-test-reports

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings August 6, 2026 09:55
@dotnetrepoman dotnetrepoman Bot added this to the August 2026 milestone Aug 6, 2026
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 75f9a66e-631b-4d19-9800-892cf968eefd

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Documents the new --report-azdo-groups option for Microsoft Testing Platform’s Azure DevOps report provider, and adds guidance about limitations when multiple test assemblies run in parallel.

Changes:

  • Add --report-azdo-groups (MTP 2.4.0) to the Azure DevOps options table, including valid values and dependency on --report-azdo.
  • Add a warning that Azure DevOps group markers can mis-nest when parallel assembly output interleaves, and recommend disabling groups for parallel multi-assembly runs.
  • Update the note to reflect that Azure DevOps options were introduced across both MTP 2.3.0 and 2.4.0.
Show a summary per file
File Description
docs/core/testing/microsoft-testing-platform-test-reports.md Documents --report-azdo-groups and adds parallel-run guidance for Azure DevOps log grouping.

Copilot's findings

Suppressed comments (1)

docs/core/testing/microsoft-testing-platform-test-reports.md:167

  • "The remaining options were added in MTP 2.3.0 or 2.4.0" reads like an either/or choice. Since the table can contain options introduced across multiple later versions, consider wording that clearly communicates "2.3.0 and later".
> The **MTP version** column lists the first MTP version that contains each option. The Azure DevOps extension itself became stable in MTP 1.9.0 with `--report-azdo` and `--report-azdo-severity`; the remaining options were added in MTP 2.3.0 or 2.4.0.
  • Files reviewed: 1/1 changed files
  • Comments generated: 1

Comment thread docs/core/testing/microsoft-testing-platform-test-reports.md Outdated
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@Evangelink
Evangelink enabled auto-merge (squash) August 6, 2026 10:00
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
|---|---|---|
| `--report-azdo` | 1.9.0 | Enables the Azure DevOps report generator. Errors and warnings are written to the output in a format that Azure DevOps understands. |
| `--report-azdo-severity` | 1.9.0 | Severity to use for reported events. Valid values are `error` (default) and `warning`. |
| `--report-azdo-groups` | 2.4.0 | Enables or disables per-assembly log groups. Valid values are `on` and `off` (default). Requires `--report-azdo`. |

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not obvious to me what this does, 1 more sentence that says what the effect is would help.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants