Skip to content

Rework MSTest docs to be feature oriented#51527

Open
Evangelink wants to merge 4 commits intomainfrom
dev/amauryleve/rewrite-mstest-doc
Open

Rework MSTest docs to be feature oriented#51527
Evangelink wants to merge 4 commits intomainfrom
dev/amauryleve/rewrite-mstest-doc

Conversation

@Evangelink
Copy link
Member

@Evangelink Evangelink commented Feb 5, 2026

Summary

Follow-up changes from #50979 (comment)


Internal previews

Toggle expand/collapse
📄 File 🔗 Preview link
docs/core/project-sdk/msbuild-props.md MSBuild reference for .NET SDK projects
docs/core/testing/index.md Testing in .NET
docs/core/testing/microsoft-testing-platform-intro.md Microsoft.Testing.Platform overview
docs/core/testing/mstest-analyzers/design-rules.md docs/core/testing/mstest-analyzers/design-rules
docs/core/testing/mstest-analyzers/mstest0001.md MSTEST0001: Explicitly enable or disable tests parallelization
docs/core/testing/mstest-analyzers/overview.md MSTest code analysis
docs/core/testing/mstest-analyzers/usage-rules.md MSTest usage rules
docs/core/testing/unit-testing-csharp-with-mstest.md Get started with MSTest and C#
docs/core/testing/unit-testing-fsharp-with-mstest.md docs/core/testing/unit-testing-fsharp-with-mstest
docs/core/testing/unit-testing-mstest-getting-started.md Get started with MSTest
docs/core/testing/unit-testing-mstest-intro.md MSTest overview
docs/core/testing/unit-testing-mstest-running-tests.md Run tests with MSTest
docs/core/testing/unit-testing-mstest-sdk.md MSTest SDK configuration
docs/core/testing/unit-testing-mstest-writing-tests-assertions.md MSTest assertions
docs/core/testing/unit-testing-mstest-writing-tests-controlling-execution.md Test execution and control in MSTest
docs/core/testing/unit-testing-mstest-writing-tests-data-driven.md docs/core/testing/unit-testing-mstest-writing-tests-data-driven
docs/core/testing/unit-testing-mstest-writing-tests-lifecycle.md MSTest lifecycle
docs/core/testing/unit-testing-mstest-writing-tests-organizing.md Run only integration tests
docs/core/testing/unit-testing-mstest-writing-tests.md Write tests with MSTest
docs/core/testing/unit-testing-visual-basic-with-mstest.md Get started with MSTest and Visual Basic
docs/navigate/devops-testing/index.yml docs/navigate/devops-testing/index
docs/navigate/devops-testing/toc.yml docs/navigate/devops-testing/toc

@Evangelink Evangelink marked this pull request as ready for review February 5, 2026 21:15
Copilot AI review requested due to automatic review settings February 5, 2026 21:15
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This pull request reworks the MSTest documentation to be feature-oriented, following up on PR #50979. The changes reorganize documentation from an attribute-centric structure to a feature-based organization that better supports developers learning MSTest.

Changes:

  • Deleted the comprehensive attributes page (unit-testing-mstest-writing-tests-attributes.md) and redistributed content into feature-specific documents
  • Created new feature-oriented documentation files: data-driven testing, lifecycle management, execution control, and test organization
  • Reorganized the table of contents to group documentation by testing concepts rather than API elements
  • Updated cross-references throughout the documentation
  • Added redirects for deleted/moved pages

Reviewed changes

Copilot reviewed 25 out of 25 changed files in this pull request and generated 6 comments.

Show a summary per file
File Description
docs/navigate/devops-testing/toc.yml Reorganized MSTest section, moved framework order (MSTest first, then NUnit, xUnit)
docs/navigate/devops-testing/index.yml Updated link from runner intro to running tests overview
docs/core/testing/unit-testing-mstest-writing-tests.md Rewrote as feature overview with quick reference tables
docs/core/testing/unit-testing-mstest-writing-tests-organizing.md New file covering test metadata and organization attributes
docs/core/testing/unit-testing-mstest-writing-tests-lifecycle.md Expanded lifecycle documentation with detailed examples
docs/core/testing/unit-testing-mstest-writing-tests-data-driven.md New comprehensive guide to data-driven testing
docs/core/testing/unit-testing-mstest-writing-tests-controlling-execution.md New guide for execution control attributes
docs/core/testing/unit-testing-mstest-writing-tests-assertions.md Enhanced assertions documentation
docs/core/testing/unit-testing-mstest-intro.md Expanded overview with platform support details
docs/core/testing/unit-testing-mstest-getting-started.md Restructured getting started guide
docs/core/testing/unit-testing-mstest-sdk.md Updated to focus on configuration
docs/core/testing/unit-testing-mstest-running-tests.md Consolidated runner information from deleted intro file
Language-specific tutorials (C#, F#, VB) Updated titles for consistency
Analyzer documentation Updated cross-references to new document structure
.openpublishing.redirection.core.json Added redirects for deleted pages

ms.date: 08/30/2017
---
# Unit testing F# libraries in .NET Core using dotnet test and MSTest
# Get started with MSTest and F\#
Copy link

Copilot AI Feb 5, 2026

Choose a reason for hiding this comment

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

Incorrect use of escaped hash character in title. The title should be "# Get started with MSTest and F#" not "# Get started with MSTest and F#". The backslash before the hash is unnecessary and will render incorrectly. The hash character doesn't need escaping in markdown headings.

Copilot uses AI. Check for mistakes.
ai-usage: ai-assisted
---
# Unit testing C# with MSTest and .NET
# Get started with MSTest and C\#
Copy link

Copilot AI Feb 5, 2026

Choose a reason for hiding this comment

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

Incorrect use of escaped hash character in title. The title should be "# Get started with MSTest and C#" not "# Get started with MSTest and C#". The backslash before the hash is unnecessary and will render incorrectly. The hash character doesn't need escaping in markdown headings.

Copilot uses AI. Check for mistakes.
Comment on lines +447 to +451
public static IEnumerable<int> GetData()
{
yield return 1;
yield return 2;
yield return 3;
Copy link

Copilot AI Feb 5, 2026

Choose a reason for hiding this comment

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

Return type mismatch in GetData method. The method returns IEnumerable<int> but should return IEnumerable<object[]> to work with the DynamicData attribute. Each data row should be wrapped in an object array. Change the return type to IEnumerable<object[]> and wrap each value: yield return new object[] { 1 };

Suggested change
public static IEnumerable<int> GetData()
{
yield return 1;
yield return 2;
yield return 3;
public static IEnumerable<object[]> GetData()
{
yield return new object[] { 1 };
yield return new object[] { 2 };
yield return new object[] { 3 };

Copilot uses AI. Check for mistakes.
1. Run DisposeAsync if implemented
1. Run Dispose if implemented
- [Write tests in MSTest](unit-testing-mstest-writing-tests.md)
- [Write tests in MSTest](unit-testing-mstest-writing-tests.md)
Copy link

Copilot AI Feb 5, 2026

Choose a reason for hiding this comment

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

Duplicate link in the "See also" section. The link to "Write tests in MSTest" appears twice on consecutive lines. Remove one of these duplicate entries.

Suggested change
- [Write tests in MSTest](unit-testing-mstest-writing-tests.md)

Copilot uses AI. Check for mistakes.
## See also

- [Write tests in MSTest](unit-testing-mstest-writing-tests.md)
- [Write tests in MSTest](unit-testing-mstest-writing-tests.md)
Copy link

Copilot AI Feb 5, 2026

Choose a reason for hiding this comment

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

Duplicate link in the "See also" section. The link to "Write tests in MSTest" appears twice on consecutive lines. Remove one of these duplicate entries.

Suggested change
- [Write tests in MSTest](unit-testing-mstest-writing-tests.md)

Copilot uses AI. Check for mistakes.
## See also

- [Write tests in MSTest](unit-testing-mstest-writing-tests.md)
- [Write tests in MSTest](unit-testing-mstest-writing-tests.md)
Copy link

Copilot AI Feb 5, 2026

Choose a reason for hiding this comment

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

Duplicate link in the "See also" section. The link to "Write tests in MSTest" appears twice on consecutive lines. Remove one of these duplicate entries.

Suggested change
- [Write tests in MSTest](unit-testing-mstest-writing-tests.md)

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant