Document AzureDevOps plugin

docs/core/testing/microsoft-testing-platform-extensions-test-reports.md

@@ -27,3 +27,35 @@
 | `--report-trx-filename` | The name of the generated TRX report. The default name matches the following format `<UserName>_<MachineName>_<yyyy-MM-dd HH:mm:ss>.trx`. |
 
 The report is saved inside the default _TestResults_ folder that can be specified through the `--results-directory` command line argument.
+
+## Azure DevOps reports
+
+Azure DevOps report plugin enhances test running for developers that host their code on GitHub, but build on Azure DevOps build agents. It adds additional information to failures to show failure directly in GitHub PR.
+
+![](./media/test-azdoreport-failure.png)
+
+The extension is shipped in [Microsoft.Testing.Extensions.AzureDevOpsReport](https://nuget.org/packages/Microsoft.Testing.Extensions.AzureDevOpsReport) package.
+
+> [!IMPORTANT]
+> The package is shipped with Microsoft .NET library closed-source free to use licensing model.
+
+The available options as follows:
+
+| Option | Description |
+|--|--|
+| `--report-azdo` | Enable outputting errors / warnings in CI builds. |
+| `--report-azdo-severity` | Severity to use for the reported event. Options are: `error` (default) and `warning`. |
+
+The extension automatically detects that it is running in continuous integration (CI) environment by checking the `TF_BIULD` environment variable.
+
+### Determining the line to report
+
+To highlight the correct line in code where failure occured, AzureDevOps report plugin searches the error stacktrace for a file that exists in the current repository.
+
+To determine this it:
+
+- finds the repository root, this is done by searching the `.git` directory closest to the location from where the test application is started (as determined by `AppContext.BaseDirectory`)
+- finds the first line in stack trace that has file location and line (the library needs to have debug symbols)
+- excludes all files that end with `Assert.cs` to avoid showing details of your assertion implementations or wrappers
+- excludes all files that don't exist on disk (typically those are lines from external libraries that ship debug symbols e.g. MSTest)
+

docs/core/testing/unit-testing-mstest-sdk.md

@@ -104,6 +104,7 @@ You can set the profile using the property `TestingExtensionsProfile` with one o
   * [Hot Reload](./microsoft-testing-platform-extensions-hosting.md#hot-reload)
   * [Retry](./microsoft-testing-platform-extensions-policy.md#retry)
   * [Trx Report](./microsoft-testing-platform-extensions-test-reports.md#visual-studio-test-reports)
+  * [AzureDevOpsReport](./microsoft-testing-platform-extensions-test-reports.md#azure-devops-reports)
 
 Here's a full example, using the `None` profile: