Apply suggestions from code review

Co-authored-by: Heitor Tashiro Sergent <[email protected]>

Author: 2 people

docs/sources/k6/next/javascript-api/jslib/testing/_index.md

@@ -1,6 +1,5 @@
 ---
 title: 'testing'
-head_title: 'testing'
 description: 'The k6 testing library provides test assertion capabilities for both protocol and browser testing.'
 weight: 00
 ---
@@ -10,7 +9,7 @@ weight: 00
 The k6 testing library provides assertion capabilities for both protocol and browser testing, and draws inspiration from Playwright's test API design. The entire library is centered around the [`expect()`](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/jslib/k6-testing/expect) function, which can be configured for convenience.
 
 {{< admonition type="note" >}}
-The k6 testing library source code can be found on [GitHub](https://github.com/grafana/k6-jslib-testing).
+The k6 testing library source code is available on [GitHub](https://github.com/grafana/k6-jslib-testing).
 {{< /admonition >}}
 
 ## Features
@@ -23,7 +22,7 @@ The k6 testing library source code can be found on [GitHub](https://github.com/g
 
 ## Usage
 
-To use the testing library in your k6 script, import it in your tests, directly from the jslib repository:
+To use the testing library in your k6 script, import it in your tests directly from the jslib repository:
 
 ```javascript
 import { expect } from 'https://jslib.k6.io/k6-testing/{{< param "JSLIB_AWS_VERSION" >}}/index.js';
@@ -71,7 +70,7 @@ export default async function () {
 
 ## Configuration
 
-Create configured expect instances for custom behavior:
+Create configured `expect` instances for custom behavior:
 
 ```javascript
 import { expect } from 'https://jslib.k6.io/k6-testing/{{< param "JSLIB_AWS_VERSION" >}}/index.js';
@@ -90,17 +89,19 @@ const myExpect = expect.configure({
 
 The testing library provides two types of assertions:
 
-### [Non-Retrying Assertions]({{< relref "./non-retrying-assertions" >}})
-Synchronous assertions that evaluate immediately - perfect for testing static values, API responses, and any scenario where the expected condition should be true at the moment of evaluation.
+### [Non-Retrying Assertions](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/jslib/testing/expect/non-retrying-assertions/)
 
-### [Retrying Assertions]({{< relref "./retrying-assertions" >}})
-Asynchronous assertions that automatically retry until conditions become true or timeout - ideal for browser testing, dynamic content, and any scenario where conditions may change over time.
+Synchronous assertions that evaluate immediately. These are ideal for testing static values, API responses, and scenarios where the expected condition should be true at the moment of evaluation.
+
+### [Retrying Assertions]((https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/jslib/testing/expect/retrying-assertions/)
+
+Asynchronous assertions that automatically retry until conditions become true or timeout. These are suitable for browser testing, dynamic content, and scenarios where conditions may change over time.
 
 ## API Reference
 
 | Function | Description |
 | --- | --- |
-| [expect()]({{< relref "./expect" >}}) | Main assertion function |
-| [expect.configure()]({{< relref "./configure" >}}) | Create configured expect instances |
-| [Non-Retrying Assertions]({{< relref "./non-retrying-assertions" >}}) | Synchronous assertions for immediate evaluation |
-| [Retrying Assertions]({{< relref "./retrying-assertions" >}}) | Asynchronous assertions for dynamic content |
+| [expect()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/jslib/testing/expect) | Main assertion function |
+| [expect.configure()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/jslib/testing/configure) | Create configured expect instances |
+| [Non-Retrying Assertions](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/jslib/testing/non-retrying-assertions) | Synchronous assertions for immediate evaluation |
+| [Retrying Assertions](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/jslib/testing/retrying-assertions) | Asynchronous assertions for dynamic content |

docs/sources/k6/next/javascript-api/jslib/testing/configure.md

@@ -7,7 +7,7 @@ weight: 20
 
 # expect.configure()
 
-The `expect.configure()` method creates a new configured expect instance with custom behavior for the k6 testing library, including timeouts, display options, and soft assertion behavior. The original expect instance remains unchanged.
+The `expect.configure()` method creates a new configured `expect` instance with custom behavior for the k6 testing library, including timeouts, display options, and soft assertion behavior. The original `expect` instance remains unchanged.
 
 ## Syntax
 
@@ -27,7 +27,7 @@ const configuredExpect = expect.configure(options)
 | --- | --- | --- | --- |
 | timeout | number | `5000` | Default timeout in milliseconds for retrying assertions |
 | interval | number | `100` | Polling interval in milliseconds for retrying assertions |
-| colorize | boolean | `true` | Enable colored output in assertion messages |
+| colorize | boolean | `true` | Enable colorized output in assertion messages |
 | display | string | `"pretty"` | Output format for assertion messages (`"pretty"` or `"inline"`) |
 | softMode | string | `"fail"` | Soft assertion behavior (`"fail"` or `"throw"`) |
 
@@ -41,7 +41,7 @@ const configuredExpect = expect.configure(options)
 
 The `expect.configure()` method creates a new expect instance with custom configuration options. This new instance can be used in place of the default expect function, and will apply the specified configuration to all assertions made with it. The original expect instance remains unchanged and continues to use the default configuration.
 
-### Timeout Configuration
+### Timeout configuration
 
 The `timeout` option controls how long retrying assertions will wait for a condition to become true:
 

docs/sources/k6/next/javascript-api/jslib/testing/expect.md

@@ -1,7 +1,6 @@
 ---
 title: 'expect()'
-head_title: 'expect()'
-description: 'Main assertion function for creating expectations in k6 tests'
+description: 'expect() is the main function for creating assertions in k6 tests'
 weight: 10
 ---
 
@@ -75,7 +74,7 @@ expect('hello').not.toContain('world');
 
 ### Soft Assertions
 
-By default, failed assertions will terminate the test execution. The k6 testing library also supports soft assertions: failed soft assertions do not terminate the test execution, but mark the test as failed, leading k6 to eventually exit with code `110`.
+By default, failed assertions will terminate the test execution. Soft assertions, on the other hand, don't terminate the test execution when they fail, but mark the test as failed, leading k6 to eventually exit with code `110`.
 
 ```javascript
 import exec from "k6/execution";
@@ -161,7 +160,7 @@ export default async function () {
 }
 ```
 
-## Available Assertion Methods
+## Assertion methods
 
 ### Non-Retrying Assertions
 

docs/sources/k6/next/javascript-api/jslib/testing/non-retrying-assertions/_index.md

@@ -1,6 +1,5 @@
 ---
 title: 'Non-Retrying Assertions'
-head_title: 'Non-Retrying Assertions'
 description: 'Synchronous assertions that evaluate immediately'
 weight: 40
 ---
@@ -9,7 +8,6 @@ weight: 40
 
 Non-retrying assertions are synchronous assertions that allow to test any conditions, but do not auto-retry. They are ideal for testing static values, API responses, and any scenario where the expected condition should be true at the moment of evaluation. 
 
-## Overview
 
 Non-retrying assertions differ from [retrying assertions](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/jslib/k6-testing/retrying-assertions) in that they:
 
@@ -44,7 +42,7 @@ Non-retrying assertions are best suited for:
 - **Known state verification** - Checking values that should be immediately available
 
 
-## Available Non-Retrying Assertions
+## Non-retrying assertions methods
 
 ### Equality Assertions