docs: Update versions to 5.2.4 and modernize Screenplay Playwright examples

Update dependency versions across documentation pages (Serenity 5.2.4,
JUnit 6.0.3, Cucumber 7.34.2, Playwright 1.58.0). Update the Screenplay
Playwright reference to recommend @UsePlaywright + withPage(page) as the
primary approach, with manual lifecycle management as an alternative.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: wakaleo

docs/cucumber/cucumber-junit5.md

@@ -32,9 +32,9 @@ Add the following dependencies to your `pom.xml`:
 
 ```xml
 <properties>
-    <serenity.version>5.2.2</serenity.version>
-    <cucumber.version>7.33.0</cucumber.version>
-    <junit.version>6.0.1</junit.version>
+    <serenity.version>5.2.4</serenity.version>
+    <cucumber.version>7.34.2</cucumber.version>
+    <junit.version>6.0.3</junit.version>
 </properties>
 
 <dependencies>
@@ -70,9 +70,9 @@ For Gradle, add to your `build.gradle`:
 
 ```groovy
 dependencies {
-    testImplementation "net.serenity-bdd:serenity-cucumber:5.2.2"
-    testImplementation "io.cucumber:cucumber-junit-platform-engine:7.33.0"
-    testImplementation "org.junit.platform:junit-platform-suite:6.0.1"
+    testImplementation "net.serenity-bdd:serenity-cucumber:5.2.4"
+    testImplementation "io.cucumber:cucumber-junit-platform-engine:7.34.2"
+    testImplementation "org.junit.platform:junit-platform-suite:6.0.3"
 }
 ```
 

docs/junit5/junit5-tests.md

@@ -36,8 +36,8 @@ Add the following to your `pom.xml`:
 
 ```xml
 <properties>
-    <serenity.version>5.2.2</serenity.version>
-    <junit.version>6.0.1</junit.version>
+    <serenity.version>5.2.4</serenity.version>
+    <junit.version>6.0.3</junit.version>
 </properties>
 
 <dependencies>
@@ -95,12 +95,12 @@ For Gradle, add to your `build.gradle`:
 
 ```groovy
 dependencies {
-    testImplementation "net.serenity-bdd:serenity-junit5:5.2.2"
-    testImplementation "net.serenity-bdd:serenity-screenplay:5.2.2"
-    testImplementation "net.serenity-bdd:serenity-screenplay-webdriver:5.2.2"
+    testImplementation "net.serenity-bdd:serenity-junit5:5.2.4"
+    testImplementation "net.serenity-bdd:serenity-screenplay:5.2.4"
+    testImplementation "net.serenity-bdd:serenity-screenplay-webdriver:5.2.4"
 
-    testImplementation "org.junit.jupiter:junit-jupiter-api:6.0.1"
-    testRuntimeOnly "org.junit.jupiter:junit-jupiter-engine:6.0.1"
+    testImplementation "org.junit.jupiter:junit-jupiter-api:6.0.3"
+    testRuntimeOnly "org.junit.jupiter:junit-jupiter-engine:6.0.3"
 
     testImplementation "org.assertj:assertj-core:3.24.2"
 }

docs/playwright/getting-started.md

@@ -24,9 +24,9 @@ Add the following dependencies to your `pom.xml`:
 
 ```xml
 <properties>
-    <serenity.version>5.1.0</serenity.version>
-    <playwright.version>1.57.0</playwright.version>
-    <junit.version>6.0.1</junit.version>
+    <serenity.version>5.2.4</serenity.version>
+    <playwright.version>1.58.0</playwright.version>
+    <junit.version>6.0.3</junit.version>
 </properties>
 
 <dependencies>

docs/playwright/screenplay-tutorial.md

@@ -22,7 +22,7 @@ Create a Maven project with these dependencies:
 
 ```xml
 <properties>
-    <serenity.version>5.1.1</serenity.version>
+    <serenity.version>5.2.4</serenity.version>
     <playwright.version>1.58.0</playwright.version>
 </properties>
 

docs/playwright/screenplay.md

@@ -38,7 +38,7 @@ Add these dependencies to your `pom.xml`:
 
 ```xml
 <properties>
-    <serenity.version>5.1.1</serenity.version>
+    <serenity.version>5.2.4</serenity.version>
     <playwright.version>1.58.0</playwright.version>
 </properties>
 

docs/playwright/tutorial-todomvc.md

@@ -34,8 +34,8 @@ First, create a Maven project with these dependencies in `pom.xml`:
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <maven.compiler.source>17</maven.compiler.source>
         <maven.compiler.target>17</maven.compiler.target>
-        <serenity.version>5.1.0</serenity.version>
-        <playwright.version>1.57.0</playwright.version>
+        <serenity.version>5.2.4</serenity.version>
+        <playwright.version>1.58.0</playwright.version>
     </properties>
 
     <dependencies>

docs/screenplay/screenplay-playwright.md

@@ -32,12 +32,41 @@ Add the following dependency to your project:
 
 ### The BrowseTheWebWithPlaywright Ability
 
-To use Playwright with Screenplay, actors need the `BrowseTheWebWithPlaywright` ability:
+To use Playwright with Screenplay, actors need the `BrowseTheWebWithPlaywright` ability. The recommended approach is to use Playwright's `@UsePlaywright` annotation, which manages the browser lifecycle automatically:
 
 ```java
+import net.serenitybdd.junit5.SerenityJUnit5Extension;
+import net.serenitybdd.playwright.junit5.SerenityPlaywrightExtension;
+import net.serenitybdd.screenplay.Actor;
 import net.serenitybdd.screenplay.playwright.abilities.BrowseTheWebWithPlaywright;
 import com.microsoft.playwright.*;
 
+@ExtendWith(SerenityJUnit5Extension.class)
+@ExtendWith(SerenityPlaywrightExtension.class)
+@UsePlaywright(ChromeHeadlessOptions.class)
+class MyScreenplayTest {
+
+    Actor alice;
+
+    @BeforeEach
+    void setUp(Page page) {
+        alice = Actor.named("Alice");
+        alice.can(BrowseTheWebWithPlaywright.withPage(page));
+    }
+}
+```
+
+The `withPage(Page)` factory method wraps a `@UsePlaywright`-managed page. Screenplay reuses the existing browser — no duplicate browser instance is created. On teardown, Screenplay only unregisters the page; it does **not** close the Page, BrowserContext, Browser, or Playwright instance.
+
+:::tip `@SerenityPlaywright` shorthand
+You can use the `@SerenityPlaywright` meta-annotation as a shorthand for both `@ExtendWith(SerenityJUnit5Extension.class)` and `@ExtendWith(SerenityPlaywrightExtension.class)`.
+:::
+
+#### Alternative: Manual Lifecycle Management
+
+If you need full control over the browser lifecycle, you can manage it manually:
+
+```java
 Playwright playwright = Playwright.create();
 Browser browser = playwright.chromium().launch();
 
@@ -47,10 +76,28 @@ alice.can(BrowseTheWebWithPlaywright.using(browser));
 
 ### Configuration
 
-You can configure Playwright behavior using environment variables or programmatically:
+When using `@UsePlaywright`, configure browser options with an `OptionsFactory`:
+
+```java
+public class ChromeHeadlessOptions implements OptionsFactory {
+    @Override
+    public Options getOptions() {
+        return new Options()
+                .setHeadless(true)
+                .setLaunchOptions(
+                        new BrowserType.LaunchOptions()
+                                .setArgs(Arrays.asList(
+                                    "--no-sandbox",
+                                    "--disable-extensions",
+                                    "--disable-gpu"))
+                );
+    }
+}
+```
+
+For manual lifecycle management, configure programmatically:
 
 ```java
-// Launch with options
 BrowserType.LaunchOptions options = new BrowserType.LaunchOptions()
     .setHeadless(false)
     .setSlowMo(100);
@@ -1089,9 +1136,9 @@ Simply enable console and/or network capture at the start of your tests:
 
 ```java
 @BeforeEach
-void setup() {
-    alice = Actor.named("Alice")
-        .whoCan(BrowseTheWebWithPlaywright.usingTheDefaultConfiguration());
+void setup(Page page) {
+    alice = Actor.named("Alice");
+    alice.can(BrowseTheWebWithPlaywright.withPage(page));
 
     // Enable capture for failure evidence
     alice.attemptsTo(
@@ -1965,22 +2012,29 @@ When migrating from `serenity-screenplay-webdriver`:
 ## Complete Example
 
 ```java
+import com.microsoft.playwright.Page;
+import net.serenitybdd.annotations.SerenityPlaywright;
 import net.serenitybdd.screenplay.Actor;
 import net.serenitybdd.screenplay.playwright.abilities.BrowseTheWebWithPlaywright;
 import net.serenitybdd.screenplay.playwright.interactions.*;
 import net.serenitybdd.screenplay.playwright.questions.*;
 import net.serenitybdd.screenplay.playwright.ui.*;
+import com.microsoft.playwright.junit.UsePlaywright;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+
 import static org.assertj.core.api.Assertions.assertThat;
 
-public class ShoppingCartTest {
+@SerenityPlaywright
+@UsePlaywright
+class ShoppingCartTest {
 
-    Actor alice = Actor.named("Alice");
+    Actor alice;
 
     @BeforeEach
-    void setup() {
-        Playwright playwright = Playwright.create();
-        Browser browser = playwright.chromium().launch();
-        alice.can(BrowseTheWebWithPlaywright.using(browser));
+    void setup(Page page) {
+        alice = Actor.named("Alice");
+        alice.can(BrowseTheWebWithPlaywright.withPage(page));
     }
 
     @Test