Skip to content

Rework MSTest docs to be feature oriented#51527

Merged
Evangelink merged 14 commits intomainfrom
dev/amauryleve/rewrite-mstest-doc
Feb 9, 2026
Merged

Rework MSTest docs to be feature oriented#51527
Evangelink merged 14 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)

Fixes microsoft/testfx#5659


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 C# and MSTest
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-testcontext.md MSTest TestContext
docs/core/testing/unit-testing-mstest-writing-tests.md Write tests with MSTest
docs/core/testing/unit-testing-visual-basic-with-mstest.md docs/core/testing/unit-testing-visual-basic-with-mstest
docs/navigate/devops-testing/index.yml .NET DevOps, testing, and deployment documentation
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

Evangelink and others added 3 commits February 6, 2026 07:30
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…n.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copy link
Member

@Youssef1313 Youssef1313 left a comment

Choose a reason for hiding this comment

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

Not fully reviewed yet, but so far LGTM aside from some comments.

Copy link
Contributor

@meaghanlewis meaghanlewis left a comment

Choose a reason for hiding this comment

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

These changes LGTM. I left a handful of suggestions for you.

Evangelink and others added 4 commits February 6, 2026 21:54
Co-authored-by: Meaghan Osagie (Lewis) <mosagie@microsoft.com>
Co-authored-by: Meaghan Osagie (Lewis) <mosagie@microsoft.com>
Co-authored-by: Meaghan Osagie (Lewis) <mosagie@microsoft.com>
Co-authored-by: Meaghan Osagie (Lewis) <mosagie@microsoft.com>
@Evangelink Evangelink enabled auto-merge (squash) February 6, 2026 20:57
@Evangelink Evangelink merged commit 776b596 into main Feb 9, 2026
11 checks passed
@Evangelink Evangelink deleted the dev/amauryleve/rewrite-mstest-doc branch February 9, 2026 09:22
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.

Add a sample on how to get the cancellation token for TimeoutAttribute with CooperativeCancellation

3 participants