Apply suggestions from code review

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

Author: oleiade

docs/sources/next/javascript-api/k6-experimental/_index.md

@@ -1,6 +1,6 @@
 ---
 title: 'k6/experimental'
-excerpt: 'k6 experimental APIs'
+description: 'k6 experimental APIs'
 weight: 07
 ---
 
@@ -11,10 +11,10 @@ weight: 07
 | Modules                                                                                          | Description                                                                                                              |
 | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
 | [browser](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/browser)       | Provides browser-level APIs to interact with browsers and collect frontend performance metrics as part of your k6 tests. |
+| [fs](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/fs)                 | Provides a memory-efficient way to handle file interactions within your test scripts.                                    |
+| [grpc](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/grpc)             | Extends `k6/net/grpc` with the streaming capabilities.                                                                   |
 | [redis](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/redis)           | Functionality to interact with [Redis](https://redis.io/).                                                               |
 | [timers](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/timers)         | `setTimeout`, `clearTimeout`, `setInterval`, `clearInterval`                                                             |
 | [tracing](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/tracing)       | Support for instrumenting HTTP requests with tracing information.                                                        |
 | [webcrypto](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/webcrypto)   | Implements the [WebCrypto API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Crypto_API).                         |
 | [websockets](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/websockets) | Implements the browser's [WebSocket API](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket).                    |
-| [grpc](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/grpc)             | Extends `k6/net/grpc` with the streaming capabilities.                                                                   |
-| [fs](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/fs)                 | Provides a memory-efficient way to handle file interactions within your test scripts.                                    |

docs/sources/next/javascript-api/k6-experimental/fs/FileInfo.md

@@ -1,6 +1,6 @@
 ---
 title: 'FileInfo'
-excerpt: 'FileInfo represents information about a file.'
+description: 'FileInfo represents information about a file.'
 weight: 30
 ---
 
@@ -28,7 +28,7 @@ let file;
 })();
 
 export default async function () {
-  // About information about the file
+  // Retrieve information about the file
   const fileinfo = await file.stat();
   if (fileinfo.name != 'bonjour.txt') {
     throw new Error('Unexpected file name');

docs/sources/next/javascript-api/k6-experimental/fs/SeekMode.md

@@ -1,12 +1,12 @@
 ---
 title: 'SeekMode'
-excerpt: 'SeekMode is used to specify the position from which to seek in a file.'
+description: 'SeekMode is used to specify the position from which to seek in a file.'
 weight: 40
 ---
 
 # SeekMode
 
-The `SeekMode` enum is used to specify the position from which to [seek](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/fs/file/seek) in a file.
+The `SeekMode` enum specifies the position from which to [seek](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/fs/file/seek) in a file.
 
 ## Members
 

docs/sources/next/javascript-api/k6-experimental/fs/_index.md

@@ -1,22 +1,22 @@
 ---
 title: 'fs'
-excerpt: 'k6 fs experimental API'
+description: 'k6 fs experimental API'
 weight: 10
 ---
 
 # fs
 
 {{< docs/shared source="k6" lookup="experimental-module.md" version="<K6_VERSION>" >}}
 
-The k6 filesystem experimental module provides a memory-efficient way to handle file interactions within your test scripts. It currently offers support for opening files, reading their content, and seeking through their content, and retrieving metadata about them.
+The k6 filesystem experimental module provides a memory-efficient way to handle file interactions within your test scripts. It currently offers support for opening files, reading their content, seeking through their content, and retrieving metadata about them.
 
 ### Memory efficiency
 
 One of the key advantages of the filesystem module is its memory efficiency. Unlike the traditional [open](https://grafana.com/docs/k6/latest/javascript-api/init-context/open/) function, which loads a file multiple times into memory, the filesystem module reduces memory usage by loading the file as little possible, and sharing the same memory space between all VUs. This approach reduces the risk of encountering out-of-memory errors, especially in load tests involving large files.
 
 ### Notes on usage
 
-An important consideration when using the filesystem module is its handling of external file modifications. Once a file is loaded in k6, it behaves like a "view" over the content of the file. This means that if the underlying file is modified externally during a test, those changes won't be reflected in the loaded [File](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/fs/file/) instance.
+An important consideration when using the filesystem module is its handling of external file modifications. Once k6 loads a file, it behaves like a "view" over its contents. If you modify the underlying file during a test, k6 will not reflect those changes in the loaded [File](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/fs/file/) instance.
 
 ## API Overview
 

docs/sources/next/javascript-api/k6-experimental/fs/file/_index.md

@@ -1,6 +1,6 @@
 ---
 title: 'File'
-excerpt: 'File represents a file with methods for reading, seeking, and obtaining file stats.'
+description: 'File represents a file with methods for reading, seeking, and obtaining file stats.'
 weight: 10
 ---
 
@@ -20,7 +20,7 @@ The `File` class represents a file with methods for reading, seeking, and obtain
 | :------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------- |
 | [read](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/fs/file/read) | Reads up to `buffer.byteLength` bytes from the file into the passed `buffer`. Returns a promise resolving to the number of bytes read. |
 | [seek](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/fs/file/seek) | Sets the file position indicator for the file to the passed `offset` bytes. Returns a promise resolving to the new offset.             |
-| [stat](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/fs/file/stat) | Returns a promise resolving to a [FileInfo](link-to-fileinfo-doc) object with information about the file.                              |
+| [stat](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/fs/file/stat) | Returns a promise resolving to a [FileInfo](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/fs/fileinfo/) object with information about the file.                              |
 
 ## Example
 

docs/sources/next/javascript-api/k6-experimental/fs/file/read.md

@@ -1,6 +1,6 @@
 ---
 title: 'read'
-excerpt: 'the read method is used to read a chunk of the file.'
+description: 'the read method is used to read a chunk of the file.'
 weight: 20
 ---
 

docs/sources/next/javascript-api/k6-experimental/fs/file/seek.md

@@ -1,6 +1,6 @@
 ---
 title: 'seek'
-excerpt: 'seek sets the file position indicator for the file to the passed offset bytes.'
+description: 'seek sets the file position indicator for the file to the passed offset bytes.'
 weight: 30
 ---
 

docs/sources/next/javascript-api/k6-experimental/fs/file/stat.md

@@ -1,6 +1,6 @@
 ---
 title: 'stat'
-excerpt: 'stat returns a promise resolving to a FileInfo object with information about the file.'
+description: 'stat returns a promise resolving to a FileInfo object with information about the file.'
 weight: 40
 ---
 

docs/sources/next/javascript-api/k6-experimental/fs/open.md

@@ -1,14 +1,14 @@
 ---
 title: 'open'
-excerpt: 'open opens a file and returns a promise resolving to a File instance.'
+description: 'open opens a file and returns a promise resolving to a File instance.'
 weight: 20
 ---
 
 # open
 
 The `open` function opens a file and returns a promise that resolves to a [File](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/fs/file) instance. Unlike the traditional [open](https://grafana.com/docs/k6/latest/javascript-api/init-context/open/) function, which loads a file multiple times into memory, the filesystem module reduces memory usage by loading the file as little possible, and sharing the same memory space between all VUs. This approach reduces the risk of encountering out-of-memory errors, especially in load tests involving large files.
 
-### Asynchronous Nature
+### Asynchronous nature
 
 It's important to note that `open` is asynchronous and returns a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise). Due to k6's current limitation with the Init context (which doesn't support asynchronous functions directly), you need to use an asynchronous wrapper like this: