Skip to content

Commit 6fd50d2

Browse files
authored
Remove redundant MTP VSTest integration page (#52947)
Delete microsoft-testing-platform-integration-dotnet-test.md and migrate its content (Show failure per test, Show complete platform output) into unit-testing-with-dotnet-test.md. Update all inbound links and add redirect entry.
1 parent 83f7f6e commit 6fd50d2

7 files changed

+35
-116
lines changed

.openpublishing.redirection.core.json

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1583,6 +1583,10 @@
15831583
"source_path_from_root": "/docs/core/run-time-config/threading.md",
15841584
"redirect_url": "/dotnet/core/runtime-config/threading"
15851585
},
1586+
{
1587+
"source_path_from_root": "/docs/core/testing/microsoft-testing-platform-integration-dotnet-test.md",
1588+
"redirect_url": "/dotnet/core/testing/unit-testing-with-dotnet-test"
1589+
},
15861590
{
15871591
"source_path_from_root": "/docs/core/testing/using-mstest-on-windows.md",
15881592
"redirect_url": "/dotnet/core/testing/unit-testing-csharp-with-mstest",
@@ -1665,7 +1669,7 @@
16651669
},
16661670
{
16671671
"source_path_from_root": "/docs/core/testing/unit-testing-mstest-runner-integrations.md",
1668-
"redirect_url": "/dotnet/core/testing/microsoft-testing-platform-integration-dotnet-test",
1672+
"redirect_url": "/dotnet/core/testing/unit-testing-with-dotnet-test",
16691673
"redirect_document_id": true
16701674
},
16711675
{
@@ -2006,7 +2010,7 @@
20062010
},
20072011
{
20082012
"source_path_from_root": "/docs/core/testing/unit-testing-platform-integration-dotnet-test.md",
2009-
"redirect_url": "/dotnet/core/testing/microsoft-testing-platform-integration-dotnet-test"
2013+
"redirect_url": "/dotnet/core/testing/unit-testing-with-dotnet-test"
20102014
},
20112015
{
20122016
"source_path_from_root": "/docs/core/testing/unit-testing-platform-intro.md",

docs/core/project-sdk/msbuild-props.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1600,7 +1600,7 @@ The `GenerateTestingPlatformConfigurationFile` property is only available when [
16001600

16011601
The `TestingPlatformCaptureOutput` property controls whether all console output that a test executable writes is captured and hidden from the user when you use `dotnet test` to run `Microsoft.Testing.Platform` tests. By default, the console output is hidden. This output includes the banner, version information, and formatted test information. Set this property to `false` to show this information together with MSBuild output.
16021602

1603-
For more information, see [Show complete platform output](../testing/microsoft-testing-platform-integration-dotnet-test.md#show-complete-platform-output).
1603+
For more information, see [Show complete platform output](../testing/unit-testing-with-dotnet-test.md#show-complete-platform-output).
16041604

16051605
### TestingPlatformCommandLineArguments
16061606

docs/core/testing/microsoft-testing-platform-integration-dotnet-test.md

Lines changed: 0 additions & 109 deletions
This file was deleted.

docs/core/testing/unit-testing-mstest-running-tests.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ Consider the following example project file:
5353

5454
<!--
5555
Displays error on console in addition to the log file. Note that this feature comes with a performance impact.
56-
For more information, visit https://learn.microsoft.com/dotnet/core/testing/microsoft-testing-platform-integration-dotnet-test#show-failure-per-test
56+
For more information, visit https://learn.microsoft.com/dotnet/core/testing/unit-testing-with-dotnet-test#show-failure-per-test
5757
-->
5858
<TestingPlatformShowTestsFailure>true</TestingPlatformShowTestsFailure>
5959

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.date: 02/13/2024
1111
This article covers advanced configuration options for MSTest.Sdk. For basic setup and getting started, see [Get started with MSTest](./unit-testing-mstest-getting-started.md).
1212

1313
> [!IMPORTANT]
14-
> By default, MSTest.Sdk uses the [MSTest runner with Microsoft.Testing.Platform](./unit-testing-mstest-running-tests.md), including with [dotnet test](./microsoft-testing-platform-integration-dotnet-test.md). This requires modifying your CI and local CLI calls, and also impacts the available entries of the _.runsettings_. You can keep the old integrations and tools by [switching to VSTest](#select-the-runner).
14+
> By default, MSTest.Sdk uses the [MSTest runner with Microsoft.Testing.Platform](./unit-testing-mstest-running-tests.md), including with [dotnet test](./unit-testing-with-dotnet-test.md). This requires modifying your CI and local CLI calls, and also impacts the available entries of the _.runsettings_. You can keep the old integrations and tools by [switching to VSTest](#select-the-runner).
1515
>
1616
> MSTest.Sdk sets `EnableMSTestRunner` and `TestingPlatformDotnetTestSupport` to true by default. For more information about dotnet test and its different modes, see [Testing with dotnet test](./unit-testing-with-dotnet-test.md).
1717

docs/core/testing/unit-testing-nunit-runner-intro.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ Consider the following example project file:
3434

3535
<!--
3636
Displays error on console in addition to the log file. Note that this feature comes with a performance impact.
37-
For more information, visit https://learn.microsoft.com/dotnet/core/testing/microsoft-testing-platform-integration-dotnet-test#show-failure-per-test
37+
For more information, visit https://learn.microsoft.com/dotnet/core/testing/unit-testing-with-dotnet-test#show-failure-per-test
3838
-->
3939
<TestingPlatformShowTestsFailure>true</TestingPlatformShowTestsFailure>
4040

docs/core/testing/unit-testing-with-dotnet-test.md

Lines changed: 25 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,31 @@ The following list outlines the command-line options of `dotnet test` command in
6565
> </PropertyGroup>
6666
> ```
6767
68-
For more information specific to running MTP projects in VSTest mode of `dotnet test`, see [Use Microsoft.Testing.Platform with VSTest mode of `dotnet test`](./microsoft-testing-platform-integration-dotnet-test.md).
68+
#### Show failure per test
69+
70+
By default, test failures are summarized into a _.log_ file, and a single failure per test project is reported to MSBuild.
71+
72+
To show errors per failed test, specify `-p:TestingPlatformShowTestsFailure=true` on the command line, or add the `<TestingPlatformShowTestsFailure>true</TestingPlatformShowTestsFailure>` property to your project file.
73+
74+
On command line:
75+
76+
```dotnetcli
77+
dotnet test -p:TestingPlatformShowTestsFailure=true
78+
```
79+
80+
#### Show complete platform output
81+
82+
By default, all console output that the underlying test executable writes is captured and hidden from the user. This includes the banner, version information, and formatted test information.
83+
84+
To show this information together with MSBuild output, use `<TestingPlatformCaptureOutput>false</TestingPlatformCaptureOutput>`.
85+
86+
This option doesn't impact how the testing framework captures user output written by `Console.WriteLine` or other similar ways to write to the console.
87+
88+
On command line:
89+
90+
```dotnetcli
91+
dotnet test -p:TestingPlatformCaptureOutput=false
92+
```
6993

7094
#### Advanced technical details
7195

0 commit comments

Comments
 (0)