Skip to content

Conversation

@omermorad
Copy link
Contributor

PR Checklist

Please check if your PR fulfills the following requirements:

PR Type

What kind of change does this PR introduce?

  • Bugfix
  • Feature
  • Code style update (formatting, local variables)
  • Refactoring (no functional changes, no api changes)
  • Build related changes
  • Docs

What is the current behavior?

The existing recipe does not accurately reflect the current state of the library. Suites has matured significantly, and the documentation needed a rewrite to represent the library capabilities more accurately. The previous version used overly complex examples, lacked clarity, and did not provide sufficient context on when to use suites versus other testing approaches.

Issue Number: N/A

What is the new behavior?

This pull request rewrites the recipe to accurately reflect the current state of the library.

  • Uses simplified, focused examples appropriate for mid-level developers
  • Demonstrates both TestBed.solitary() and TestBed.sociable() patterns
  • Properly positions Suites alongside Test.createTestingModule() with clear guidance on when to use each
  • Adds a cross reference in /content/fundamentals/unit-testing.md (auto mocking section)
  • References createMock from @golevelup/ts-jest as a parallel alternative

Added a cross reference in /content/fundamentals/unit-testing.md (auto mocking section) that mentions Suites as an alternative for focused unit testing with automatic mock generation

Does this PR introduce a breaking change?

  • Yes
  • No

@omermorad omermorad force-pushed the docs/improve-suites-recipe-and-reference branch from 2c0278d to 977493f Compare November 23, 2025 19:56
@kamilmysliwiec kamilmysliwiec merged commit c46eb42 into nestjs:master Nov 24, 2025
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants