Mention playwright robottest browser setup for local testing (#1772)

* mention playwright robottest browser setup * Apply suggestions from code review --------- Co-authored-by: Steve Piercy <[email protected]>
plone · Nov 13, 2024 · 646b848 · 646b848
1 parent 7f75e8b
commit 646b848
Showing 1 changed file with 21 additions and 4 deletions.
diff --git a/docs/contributing/core/index.md b/docs/contributing/core/index.md
@@ -248,12 +248,29 @@ It takes 5-10 minutes to run the full unit test suite.
 If you run acceptance tests with the `--all` option, it will run tests in a real browser.
 This takes 30-40 minutes to run.
 This may repeatedly launch and close browser windows that gain focus, disrupting you from doing any other work.
-If this happens, you can install the `chromedriver` OS package.
-See https://developer.chrome.com/docs/chromedriver.
-Then run `export ROBOT_BROWSER="headlesschrome"` and again run `bin/test --all`.
+If this happens, you can use `headlesschrome` as the test browser.
+First set an environment variable.
+
+```shell
+export ROBOT_BROWSER="headlesschrome"
+```
+
+Then run all tests again.
+
+```shell
+bin/test --all
+```
+
+Plone uses [Playwright](https://playwright.dev/) to run robot tests.
+`plone.app.robotframework` provides a script to install Playwrite browsers.
+
+```shell
+./bin/rfbrowser init
+```
+
+After the script downloads and initalizes browser resources, you can run the acceptance tests.
 
 ```shell
-# Run acceptance tests
 ./bin/test --all
 ```