Apply suggestions from code review

Co-authored-by: Heitor Tashiro Sergent <heitortsergent@gmail.com>

Author: oleiade

docs/sources/k6/next/javascript-api/k6-x-dns/_index.md

@@ -4,11 +4,11 @@ description: 'k6 DNS extension API'
 weight: 11
 ---
 
-# DNS
+# k6/x/dns
 
 {{< docs/shared source="k6" lookup="extension.md" version="<K6_VERSION>" >}}
 
-The `k6/x/dns` modul enables DNS resolution testing in k6, allowing you to resolve DNS names to IP addresses using custom DNS servers or the system's default DNS configuration. This module is particularly useful for testing DNS server performance, validating DNS configurations, and incorporating DNS resolution into your load testing scenarios.
+The `k6/x/dns` module enables DNS resolution testing in k6, allowing you to resolve DNS names to IP addresses using custom DNS servers or the system's default DNS configuration. This module is useful for testing DNS server performance, validating DNS configurations, and incorporating DNS resolution into your load testing scenarios.
 
 ## Key features
 

docs/sources/k6/next/javascript-api/k6-x-dns/lookup.md

@@ -12,13 +12,13 @@ The `dns.lookup` function performs DNS resolution using the system's default DNS
 
 | Parameter | Type   | Description                                                               |
 | :-------- | :----- | :------------------------------------------------------------------------ |
-| hostname  | string | The domain name to resolve (e.g., "example.com", "k6.io")                |
+| hostname  | string | The domain name to resolve. For example, "example.com" or "k6.io".                |
 
 ## Returns
 
 A promise resolving to an array of strings, where each string is an IP address that the domain name resolves to. The function returns the same IP addresses that would be returned by the system's standard DNS resolution mechanism.
 
-## Emitted metrics
+## Metrics
 
 When using `dns.lookup`, the following metrics are automatically generated:
 

docs/sources/k6/next/javascript-api/k6-x-dns/resolve.md

@@ -12,9 +12,9 @@ The `dns.resolve` function performs DNS resolution using a specified DNS server
 
 | Parameter  | Type   | Description                                                                                                     |
 | :--------- | :----- | :-------------------------------------------------------------------------------------------------------------- |
-| query      | string | The domain name to resolve (e.g., "example.com", "k6.io")                                                      |
+| query      | string | The domain name to resolve. For example, "example.com" or "k6.io".                                                      |
 | recordType | string | The DNS record type to query. Supported values: "A" (IPv4 addresses), "AAAA" (IPv6 addresses)                 |
-| nameserver | string | The DNS server to use for resolution in the format "host:port" (e.g., "8.8.8.8:53", "[2606:4700:4700::1111]:53") |
+| nameserver | string | The DNS server to use for resolution in the format "host:port". For example, "8.8.8.8:53" or "[2606:4700:4700::1111]:53" |
 
 ## Returns
 
@@ -173,9 +173,8 @@ When using `dns.resolve`, the following metrics are automatically generated:
 
 These metrics help you monitor DNS performance and identify potential bottlenecks in your testing scenarios.
 
-## Notes on Usage
+## Best practices
 
-- **Nameserver format**: Always specify the port number (typically 53 for DNS) in the nameserver parameter
-- **Record type support**: Currently supports "A" and "AAAA" record types; additional types may be added in future versions
-- **Timeout behavior**: DNS queries have built-in timeouts; consider this when designing load tests
-- **Load testing**: Use multiple VUs and iterations to properly test DNS server performance under load
+- **Nameserver format**: Always specify the port number, typically 53 for DNS, in the nameserver parameter.
+- **Timeout behavior**: DNS queries have built-in timeouts; consider this when designing load tests.
+- **Load testing**: Use multiple VUs and iterations to properly test DNS server performance under load.

docs/sources/k6/next/shared/extension.md

@@ -4,6 +4,6 @@ title: Extension module admonition
 
 {{< admonition type="note">}}
 
-This module is implemented as an official extension and is available natively in k6, requiring no additional installation or build steps thanks to native extensions support. See the [extensions documentation](/docs/k6/<K6_VERSION>/extensions/explore) for available extensions and details.
+This module is implemented as an official extension and is available natively in k6, requiring no additional installation or build steps. Refer to the [extensions documentation](/docs/k6/<K6_VERSION>/extensions/explore) for available extensions and details.
 
 {{< /admonition >}}