sts-sponsors team mailing list archive

[Peter Makowski <mp+439377@xxxxxxxxxxxxxxxxxx>]

Peter Makowski has proposed merging ~petermakowski/maas-site-manager:docs-fe-testing into maas-site-manager:main.

Requested reviews:
  MAAS Committers (maas-committers)

For more details, see:
https://code.launchpad.net/~petermakowski/maas-site-manager/+git/site-manager/+merge/439377
-- 
Your team MAAS Committers is requested to review the proposed merge of ~petermakowski/maas-site-manager:docs-fe-testing into maas-site-manager:main.

diff --git a/frontend/README.md b/frontend/README.md
index 22e42e4..46949ed 100644
--- a/frontend/README.md
+++ b/frontend/README.md
@@ -35,14 +35,26 @@ yarn  # install dependencies
 yarn run dev
 ```
 
-## How to run tests
+## Project conventions
 
-### End to end
+## Testing
+
+We use [Playwright](https://playwright.dev/) for end-to-end tests and [Vitest](https://vitest.dev/) for unit/integration tests. We prefer integration testing over unit testing as we focus on user-centric testing and avoid testing implementation details. That makes changes and refactoring easier and helps ensure that things continue to work as expected for the end user.
+
+### How to run tests
+
+#### end-to-end
 
 ```bash
 yarn playwright test
 ```
 
+#### unit/integration
+
+```bash
+yarn test
+```
+
 ## Keeping packages up-to-date
 
 Run `yarn upgrade-all` to attempt to upgrade all packages to latest version.