diff --git a/docs/src/release-notes-java.md b/docs/src/release-notes-java.md
index 5b6f51a807..2660747c3f 100644
--- a/docs/src/release-notes-java.md
+++ b/docs/src/release-notes-java.md
@@ -54,7 +54,7 @@ Read more about it in our [API testing guide](./api-testing).
 
 ### Web-First Assertions
 
-Playwright for Java 1.18 introduces [Web-First Assertions](./api/class-playwrightassertions).
+Playwright for Java 1.18 introduces [Web-First Assertions](./api/test-assertions).
 
 Consider the following example:
 
@@ -78,7 +78,7 @@ fetched Node has the `"Submitted"` text. It will be re-fetching the node and
 checking it over and over, until the condition is met or until the timeout is
 reached. You can pass this timeout as an option.
 
-Read more in [our documentation](./api/class-playwrightassertions).
+Read more in [our documentation](./api/test-assertions).
 
 ### Locator Improvements
 
diff --git a/docs/src/release-notes-js.md b/docs/src/release-notes-js.md
index d53492394a..9a9044b140 100644
--- a/docs/src/release-notes-js.md
+++ b/docs/src/release-notes-js.md
@@ -178,7 +178,7 @@ This version was also tested against the following stable channels:
 ### Locator Improvements
 
 - [`method: Locator.dragTo`]
-- [`expect(locator).toBeChecked({ checked })`](./api/class-playwrightassertions#locator-assertions-to-be-checked)
+- [`expect(locator).toBeChecked({ checked })`](./test-assertions#locator-assertions-to-be-checked)
 - Each locator can now be optionally filtered by the text it contains:
     ```js
     await page.locator('li', { hasText: 'my item' }).locator('button').click();
@@ -188,7 +188,7 @@ This version was also tested against the following stable channels:
 
 ### Testing API improvements
 
-- [`expect(response).toBeOK()`](./api/class-playwrightassertions)
+- [`expect(response).toBeOK()`](./test-assertions)
 - [`testInfo.attach()`](./api/class-testinfo#test-info-attach)
 - [`test.info()`](./api/class-test#test-info)
 
diff --git a/docs/src/release-notes-python.md b/docs/src/release-notes-python.md
index 054b08ef8a..f856f1e37a 100644
--- a/docs/src/release-notes-python.md
+++ b/docs/src/release-notes-python.md
@@ -64,7 +64,7 @@ Read more in [our documentation](./api/class-apirequestcontext).
 
 ### Web-First Assertions
 
-Playwright for Python 1.18 introduces [Web-First Assertions](./api/class-playwrightassertions).
+Playwright for Python 1.18 introduces [Web-First Assertions](./api/test-assertions).
 
 Consider the following example:
 
@@ -91,7 +91,7 @@ fetched Node has the `"Submitted"` text. It will be re-fetching the node and
 checking it over and over, until the condition is met or until the timeout is
 reached. You can pass this timeout as an option.
 
-Read more in [our documentation](./api/class-playwrightassertions).
+Read more in [our documentation](./api/test-assertions).
 
 ### Locator Improvements
 
diff --git a/docs/src/verification.md b/docs/src/verification.md
index b105a6f301..efc77edfca 100644
--- a/docs/src/verification.md
+++ b/docs/src/verification.md
@@ -4,7 +4,7 @@ title: "Verification"
 ---
 
 :::caution
-We recommend [Web-First Assertions](./api/class-playwrightassertions) that automatically retry until the expected condition is met instead. This helps reducing the flakiness of the tests.
+We recommend [Web-First Assertions](./test-assertions) that automatically retry until the expected condition is met instead. This helps reducing the flakiness of the tests.
 :::
 
 <!-- TOC -->