[docs] Update glossary - daily scan

[Evangelink]

Glossary Updates

Scan Type: Incremental (daily) — Tuesday 2026-05-05

Terms Added:

• AwesomeAssertions: Added because PR [main] Bump AwesomeAssertions from 9.3.0 to 9.4.0 #8008 bumped the package from 9.3.0 to 9.4.0, and this package is the mandated assertion library for all test suites in the project (enforced via BannedSymbols.txt). It wasn't previously in the glossary despite being widely used and potentially confusing to newcomers who are familiar with FluentAssertions.

Changes Analyzed:

• Reviewed 1 commit from the last 24 hours
• Analyzed 1 merged PR ([main] Bump AwesomeAssertions from 9.3.0 to 9.4.0 #8008 - AwesomeAssertions version bump)

Related Changes:

• Commit 136ced0: [main] Bump AwesomeAssertions from 9.3.0 to 9.4.0 (#8008)
• PR [main] Bump AwesomeAssertions from 9.3.0 to 9.4.0 #8008: Dependabot bump of AwesomeAssertions NuGet package

Generated by Glossary Maintainer · ● 454.9K · ◷

• expires on May 7, 2026, 12:46 PM UTC

---

Note

This was originally intended as a pull request, but the git push operation failed.

Workflow Run: View run details and download patch artifact

The patch file is available in the agent artifact in the workflow run linked above.

To create a pull request with the changes:

# Download the artifact from the workflow run
gh run download 25376967230 -n agent -D /tmp/agent-25376967230

# Create a new branch
git checkout -b docs/glossary-daily-2026-05-05-2d4c70707f22b01b

# Apply the patch (--3way handles cross-repo patches where files may already exist)
git am --3way /tmp/agent-25376967230/aw-docs-glossary-daily-2026-05-05.patch

# Push the branch to origin
git push origin docs/glossary-daily-2026-05-05-2d4c70707f22b01b

# Create the pull request
gh pr create --title '[docs] Update glossary - daily scan' --base main --head docs/glossary-daily-2026-05-05-2d4c70707f22b01b --repo microsoft/testfx

Show patch (33 lines)

From 4288762d18e6d0f018ab4ec8498b54d1dbe1bf53 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Tue, 5 May 2026 12:44:13 +0000
Subject: [PATCH] docs: add AwesomeAssertions to glossary

AwesomeAssertions was bumped from 9.3.0 to 9.4.0 (PR #8008) and is the
mandated assertion library for this project's test suites. Adding a
glossary entry to explain its purpose and relationship to FluentAssertions.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 docs/glossary.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/glossary.md b/docs/glossary.md
index fde40d0..b2e9c3d 100644
--- a/docs/glossary.md
+++ b/docs/glossary.md
@@ -4,6 +4,10 @@ This glossary defines key terms and concepts used throughout the MSTest and Micr
 
 ## A
 
+### AwesomeAssertions
+
+A .NET fluent-assertion library ([NuGet: AwesomeAssertions](https://www.nuget.org/packages/AwesomeAssertions)) used in the unit and integration test suites of this project. It provides a human-readable, chainable assertion API (e.g., `result.Should().Be(42)`). AwesomeAssertions is the community-maintained fork of `FluentAssertions` created after FluentAssertions changed its license from Apache 2.0 to a commercial model; the two libraries share the same API surface. Within this project, `BannedSymbols.txt` files ban the built-in MSTest `Assert`, `CollectionAssert`, and `StringAssert` types and require `AwesomeAssertions` instead.
+
 ### ArgumentArity
 
 An MTP struct (`ArgumentArity.cs`) that defines the minimum and maximum number of values a command-line option accepts. Provides five predefined constants: `Zero` (0,0), `ZeroOrOne` (0,1), `ZeroOrMore` (0,∞), `ExactlyOne` (1,1), and `OneOrMore` (1,∞). Used by `ICommandLineOptionsProvider` implementations to declare option shapes.
-- 
2.53.0

[github-actions]

This issue was automatically closed because it expired on 2026-05-07T12:46:06.030Z.

Closed by Workflow