Clarify testing documentation: discourage monorepo-wide yarn test usage and add scoped testing examples.

This commit is contained in:
MartinBraquet
2026-07-29 20:35:36 +02:00
parent 27ecbdc811
commit 93deed6130

View File

@@ -51,13 +51,17 @@ This project uses three complementary test types. Use the right level for the jo
Quick commands
```bash
# Jest (unit + integration)
yarn test
# Jest for one workspace, or one file within it — the default while working
yarn --cwd=backend/api test path/to/file.unit.test.ts
# Playwright (E2E)
yarn test:e2e
```
> **Don't run `yarn test` across the whole monorepo.** It is slow and almost all of it is unrelated to
> any given change. Run only the workspaces a change actually touches, and prefer naming the specific
> files. The full suite is CI's job.
### Where to put test files
```filetree
@@ -150,13 +154,19 @@ standards ensures consistency, maintainability, and comprehensive test coverage.
#### Running Tests
```bash
# Run all tests
yarn test
# Run one workspace's tests
yarn --cwd=web test
# Run specific test file
yarn test path/to/test.unit.test.ts
# Run a specific test file (the workspace script already passes --config, so Jest args just append)
yarn --cwd=backend/api test path/to/test.unit.test.ts
# Run by test name
yarn --cwd=web test -t "renders profile card"
```
Scope runs to the workspaces your change touches — see the note under
[Test types at a glance](#test-types-at-a-glance).
#### Test Standards
- Test file names should convey what to expect