testing

oppia · Jan 24, 2025 · 418e87b · 418e87b
1 parent 4a31e51
commit 418e87b
Showing 1 changed file with 2 additions and 11 deletions.
diff --git a/Acceptance-Tests.md b/Acceptance-Tests.md
@@ -239,21 +239,12 @@ On the first run, a screenshot named `teachPage-snap.png` will be created and st
 - `dev-desktop-screenshots`: local development mode in desktop environments
 - `dev-mobile-screenshots`: local development mode in mobile environment, in which the `mobile` flag is used. 
 
+To introduce a new screenshot to the codebase, the test should be run in all these four modes/environments to generate each screenshot in all four folders. 
+
 On CI, we run all the acceptance tests in production mode, so the screenshots in `prod-desktop-screenshots` and `prod-mobile-screenshots` will be compared to the screenshots that are generated during CI checks. If a screenshot doesn't match on CI, it generates an image in a folder as an artifact in the GitHub workflow. For example, if the screenshot `teachPage-snap.png` fails in `logged-out-user/click-all-buttons-on-navbar.spec.ts` during the CI checks in desktop environment, a folder named `diff-snapshots-logged-out-user_click-all-buttons-on-navbar` will be created. Inside this folder, a folder named `prod-desktop-screenshots` will be created and a screenshot `teachPage-diff.png` will be stored under this folder. The screenshots `teachPage-diff.png` will show the difference between the screenshot from the codebase and the new generated screenshot, making it easier to identify the difference. 
 
 On the other hand, if the screenshot fails locally in desktop environment, the screenshot `teachPage-diff.png` will be generated and stored inside a new folder `diff-snapshots` under `logged-out-user/dev-desktop-screenshots`. 
 
-
-
-
-
-
-
-
-
-
-
-
 ## Acceptance Tests for Mobile
 
 Similar to desktop, we also have acceptance tests for mobile to ensure responsiveness and uninterrupted user journeys on small screen devices. While the tests themselves remain largely the same for both desktop and mobile, there are some differences. For instance, large full menus on desktop may be converted to dropdowns, hamburger menus, or other shortcuts on mobile, requiring additional actions to complete the tests.