Apply suggestions from code review

mdcruz · ankur22 · andrewslotin · web-flow · commit e76e2933c3a0 · 2023-05-15T15:32:13.000+01:00
Co-authored-by: Ankur &lt;ankur.agarwal@grafana.com&gt;
Co-authored-by: Andrey Slotin &lt;andrew.slotin@grafana.com&gt;
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/bringToFront.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/bringToFront.md
@@ -19,7 +19,7 @@ export default async function () {
   
   await page.goto('https://test.k6.io/browser.php');
   
-  /// perform other actions that might open up a different tab, but not focused.
+  // perform other actions that might open up a different tab, taking focus away from the initial page.
 
   page.bringToFront();
 }
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/check--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/check--options--.md
@@ -1,6 +1,6 @@
 ---
-title: 'check(selector,[options])'
-excerpt: 'Browser module: page.check(selector,[options]) method'
+title: 'check(selector[, options])'
+excerpt: 'Browser module: page.check(selector[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/click--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/click--options--.md
@@ -63,7 +63,10 @@ export default async function () {
 
   await page.goto('https://test.k6.io/');
 
-  await Promise.all([page.waitForNavigation(), page.click('a[href="/my_messages.php"]')]);
+  await Promise.all([
+    page.waitForNavigation(),
+    page.click('a[href="/my_messages.php"]'),
+  ]);
 }
 ```
 
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/content.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/content.md
@@ -17,7 +17,7 @@ export default async function () {
   const page = browser.newPage();
   
   await page.goto('https://test.k6.io/browser.php');
-  console.log(page.content()); // HTML content printed on console
+  console.log(page.content()); // HTML content printed in the console
 }
 ```
 
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/dblclick--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/dblclick--options--.md
@@ -1,6 +1,6 @@
 ---
-title: 'dblclick(selector,[options)'
-excerpt: 'Browser module: page.dblclick(selector,[options) method'
+title: 'dblclick(selector[, options])'
+excerpt: 'Browser module: page.dblclick(selector[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/dispatchEvent--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/dispatchEvent--options--.md
@@ -26,7 +26,7 @@ Dispatches HTML DOM event types e.g. `'click'`.
 
 ### eventInit
 
-Since eventInit is event-specific, please refer to the events documentation for the lists of initial properties:
+Since `eventInit` is event-specific, please refer to the events documentation for the lists of initial properties:
 
 - [DragEvent](https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent)
 - [FocusEvent](https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent)
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/emulateMedia--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/emulateMedia--options--.md
@@ -3,7 +3,7 @@ title: 'emulateMedia([options])'
 excerpt: 'Browser module: page.emulateMedia([options]) method'
 ---
 
-This method changes the `CSS media type` through the `media` argument, and/or the `'prefers-colors-scheme'` media feature, using the `colorScheme` argument.
+This method changes the CSS `@media type` through the `media` argument, and/or the `'prefers-colors-scheme'` media feature, using the `colorScheme` argument.
 
 <TableWithNestedRows>
 
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/evaluate.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/evaluate.md
@@ -1,6 +1,6 @@
 ---
-title: 'evaluate(pageFunction, [arg])'
-excerpt: 'Browser module: page.evaluate(pageFunction, [arg]) method'
+title: 'evaluate(pageFunction[, arg])'
+excerpt: 'Browser module: page.evaluate(pageFunction[, arg]) method'
 ---
 
 Returns the value of the `pageFunction` invocation.
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/evaluateHandle.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/evaluateHandle.md
@@ -1,6 +1,6 @@
 ---
-title: 'evaluateHandle(pageFunction, [arg])'
-excerpt: 'Browser module: page.evaluateHandle(pageFunction, [arg]) method'
+title: 'evaluateHandle(pageFunction[, arg])'
+excerpt: 'Browser module: page.evaluateHandle(pageFunction[, arg]) method'
 ---
 
 Returns the value of the `pageFunction` invocation as a [JSHandle](/javascript-api/k6-experimental/browser/jshandle/). 
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/fill--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/fill--options--.md
@@ -1,11 +1,11 @@
 ---
-title: 'fill(selector, value, [options])'
-excerpt: 'Browser module: page.fill(selector, value, [options]) method'
+title: 'fill(selector, value[, options])'
+excerpt: 'Browser module: page.fill(selector, value[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
 
-Use locator-based [`locator.fill(value, [options])`](/javascript-api/k6-experimental/browser/locator/fill/) instead.
+Use locator-based [`locator.fill(value[, options])`](/javascript-api/k6-experimental/browser/locator/fill/) instead.
 
 </Blockquote>
 
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/focus--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/focus--options--.md
@@ -1,6 +1,6 @@
 ---
-title: 'focus(selector, [options])'
-excerpt: 'Browser module: page.focus(selector, [options]) method'
+title: 'focus(selector[, options])'
+excerpt: 'Browser module: page.focus(selector[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/getattribute--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/getattribute--options--.md
@@ -5,7 +5,7 @@ excerpt: 'Browser module: page.getAttribute(selector, name, [options]) method'
 
 <Blockquote mod="note" title="">
 
-Use locator-based [`locator.getAttribute(name, [options])`](/javascript-api/k6-experimental/browser/locator/getattribute/) instead.
+Use locator-based [`locator.getAttribute()`](/javascript-api/k6-experimental/browser/locator/getattribute/) instead.
 
 </Blockquote>
 
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/goto--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/goto--options--.md
@@ -3,7 +3,7 @@ title: 'goto(url, [options])'
 excerpt: 'Browser module: page.goto(url, [options]) method'
 ---
 
-Navigates to the specified url and returns the main resource response.
+Navigates to the specified URL and returns the main resource response.
 
 Navigating to `about:blank` or navigation to the same URL with a different hash, will succeed and return `null`.
 
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/hover--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/hover--options--.md
@@ -1,6 +1,6 @@
 ---
-title: 'hover(selector, [options])'
-excerpt: 'Browser module: page.hover(selector, [options]) method'
+title: 'hover(selector[, options])'
+excerpt: 'Browser module: page.hover(selector[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/innerhtml--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/innerhtml--options--.md
@@ -1,6 +1,6 @@
 ---
-title: 'innerHTML(selector, [options])'
-excerpt: 'Browser module: page.innerHTML(selector, [options) method'
+title: 'innerHTML(selector[, options])'
+excerpt: 'Browser module: page.innerHTML(selector[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/innertext--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/innertext--options--.md
@@ -1,6 +1,6 @@
 ---
-title: 'innerText(selector, [options])'
-excerpt: 'Browser module: page.innerText(selector, [options]) method'
+title: 'innerText(selector[, options])'
+excerpt: 'Browser module: page.innerText(selector[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/inputvalue--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/inputvalue--options--.md
@@ -1,6 +1,6 @@
 ---
-title: 'inputValue(selector, [options])'
-excerpt: 'Browser module: page.inputValue(selector, [options]) method'
+title: 'inputValue(selector[, options])'
+excerpt: 'Browser module: page.inputValue(selector[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/ischecked--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/ischecked--options--.md
@@ -1,6 +1,6 @@
 ---
-title: 'isChecked(selector, [options])'
-excerpt: 'Browser module: page.isChecked(selector, [options]) method'
+title: 'isChecked(selector[, options])'
+excerpt: 'Browser module: page.isChecked(selector[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/isdisabled--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/isdisabled--options--.md
@@ -1,6 +1,6 @@
 ---
-title: 'isDisabled(selector, [options])'
-excerpt: 'Browser module: page.isDisabled(selector, [options]) method'
+title: 'isDisabled(selector[, options])'
+excerpt: 'Browser module: page.isDisabled(selector[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/iseditable--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/iseditable--options--.md
@@ -1,6 +1,6 @@
 ---
-title: 'isEditable(selector, [options])'
-excerpt: 'Browser module: page.isEditable(selector, [options]) method'
+title: 'isEditable(selector[, options])'
+excerpt: 'Browser module: page.isEditable(selector[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/isenabled--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/isenabled--options--.md
@@ -1,6 +1,6 @@
 ---
-title: 'isEnabled(selector, [options])'
-excerpt: 'Browser module: page.isEnabled(selector, [options]) method'
+title: 'isEnabled(selector[, options])'
+excerpt: 'Browser module: page.isEnabled(selector[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/ishidden--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/ishidden--options--.md
@@ -1,6 +1,6 @@
 ---
-title: 'isHidden(selector, [options])'
-excerpt: 'Browser module: page.isHidden(selector, [options) method'
+title: 'isHidden(selector[, options])'
+excerpt: 'Browser module: page.isHidden(selector[, options) method'
 ---
 
 <Blockquote mod="note" title="">
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/isvisible--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/isvisible--options--.md
@@ -1,6 +1,6 @@
 ---
-title: 'isVisible(selector, [options])'
-excerpt: 'Browser module: page.isVisible(selector, [options]) method'
+title: 'isVisible(selector[, options])'
+excerpt: 'Browser module: page.isVisible(selector[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/keyboard.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/keyboard.md
@@ -1,5 +1,5 @@
 ---
-title: 'keyboard()'
+title: 'keyboard'
 excerpt: 'Browser module: page.keyboard method'
 ---
 
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/mainframe.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/mainframe.md
@@ -3,7 +3,7 @@ title: 'mainFrame()'
 excerpt: 'Browser module: page.mainFrame method'
 ---
 
-The page's main frame. Page is made up of frames in a hierarchical. At the top is `mainFrame`. A page is guaranteed to have a mainFrame.
+The page's main frame. Page is made up of frames in a hierarchical. At the top is `mainFrame`. A page is guaranteed to have a main frame.
 
 ### Returns
 
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/mouse.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/mouse.md
@@ -1,5 +1,5 @@
 ---
-title: 'mouse()'
+title: 'mouse'
 excerpt: 'Browser module: page.mouse method'
 ---
 
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/opener.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/opener.md
@@ -3,7 +3,7 @@ title: 'opener()'
 excerpt: 'Browser module: page.mouse method'
 ---
 
-Returns the page that opened the current page. The first page that is navigated to will have a null opener.
+Returns the page that opened the current page. The first page that is navigated to will have a `null` opener.
 
 ### Example
 
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/press--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/press--options--.md
@@ -5,7 +5,7 @@ excerpt: 'Browser module: page.press(selector, key, [options]) method'
 
 <Blockquote mod="note" title="">
 
-Use locator-based [`locator.press(key, [options])`](/javascript-api/k6-experimental/browser/locator/press/) instead.
+Use locator-based [`locator.press()`](/javascript-api/k6-experimental/browser/locator/press/) instead.
 
 </Blockquote>
 
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/selectoption--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/selectoption--options--.md
@@ -5,7 +5,7 @@ excerpt: 'Browser module: page.selectOption(selector, values, [options]) method'
 
 <Blockquote mod="note" title="">
 
-Use locator-based [`locator.selectOptions(values, [options])`](/javascript-api/k6-experimental/browser/locator/selectoptions/) instead.
+Use locator-based [`locator.selectOptions()`](/javascript-api/k6-experimental/browser/locator/selectoptions/) instead.
 
 </Blockquote>
 
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/setcontent--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/setcontent--options--.md
@@ -3,7 +3,7 @@ title: 'setContent(html, [options])'
 excerpt: 'Browser module: page.setContent(html, [options]) method'
 ---
 
-Sets the supplied html string to the current page.
+Sets the supplied HTML string to the current page.
 
 <TableWithNestedRows>
 
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/tap--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/tap--options--.md
@@ -1,6 +1,6 @@
 ---
-title: 'tap(selector, [options])'
-excerpt: 'Browser module: locator.tap(selector, [options]) method'
+title: 'tap(selector[, options])'
+excerpt: 'Browser module: locator.tap(selector[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/textcontent--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/textcontent--options--.md
@@ -1,6 +1,6 @@
 ---
-title: 'textContent(selector, [options])'
-excerpt: 'Browser module: locator.textContent(selector, [options]) method'
+title: 'textContent(selector[, options])'
+excerpt: 'Browser module: locator.textContent(selector[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/title.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/title.md
@@ -1,6 +1,6 @@
 ---
 title: 'title()'
-excerpt: 'Browser module: page.title() method'
+excerpt: 'Browser module: page.title method'
 ---
 
 Returns the page's title.
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/touchscreen.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/touchscreen.md
@@ -1,5 +1,5 @@
 ---
-title: 'touchScreen()'
+title: 'touchScreen'
 excerpt: 'Browser module: page.touchScreen method'
 ---
 
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/type--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/type--options--.md
@@ -1,11 +1,11 @@
 ---
-title: 'type(selector, text, [options])'
-excerpt: 'Browser module: page.type(selector, text, [options]) method'
+title: 'type(selector, text[, options])'
+excerpt: 'Browser module: page.type(selector, text[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
 
-Use locator-based [`locator.type(text, [options])`](/javascript-api/k6-experimental/browser/locator/type/) instead.
+Use locator-based [`locator.type()`](/javascript-api/k6-experimental/browser/locator/type/) instead.
 
 </Blockquote>
 
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/uncheck--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/uncheck--options--.md
@@ -1,6 +1,6 @@
 ---
-title: 'uncheck(selector, [options])'
-excerpt: 'Browser module: page.uncheck(selector, [options]) method'
+title: 'uncheck(selector[, options])'
+excerpt: 'Browser module: page.uncheck(selector[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/waitforfunction--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/waitforfunction--options--.md
@@ -1,6 +1,6 @@
 ---
-title: 'waitForFunction(pageFunction, arg, [options])'
-excerpt: 'Browser module: page.waitForFunction(pageFunction, arg, [options]) method'
+title: 'waitForFunction(pageFunction, arg[, options])'
+excerpt: 'Browser module: page.waitForFunction(pageFunction, arg[, options]) method'
 ---
 
 Returns when the `pageFunction` returns a truthy value.
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/waitforloadstate--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/waitforloadstate--options--.md
@@ -1,6 +1,6 @@
 ---
-title: 'waitForLoadState(state, [options])'
-excerpt: 'Browser module: page.waitForLoadState(state, [options]) method'
+title: 'waitForLoadState(state[, options])'
+excerpt: 'Browser module: page.waitForLoadState(state[, options]) method'
 ---
 
 <Blockquote mod="attention">
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/waitfornavigation--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/waitfornavigation--options--.md
@@ -1,6 +1,6 @@
 ---
 title: 'waitForNavigation([options])'
-excerpt: 'Browser module: page.waitForLoadState(state, [options]) method'
+excerpt: 'Browser module: page.waitForNavigation([options]) method'
 ---
 
 Waits for the given navigation lifecycle event to occur and returns the main resource response.
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/waitforselector--options--.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/waitforselector--options--.md
@@ -1,6 +1,6 @@
 ---
-title: 'waitForSelector(selector, [options])'
-excerpt: 'Browser module: page.waitForSelector(selector, [options]) method'
+title: 'waitForSelector(selector[, options])'
+excerpt: 'Browser module: page.waitForSelector(selector[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
diff --git a/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/workers.md b/src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/workers.md
@@ -3,7 +3,7 @@ title: 'workers()'
 excerpt: 'Browser module: page.workers method'
 ---
 
-This method returns an array of the dedicated WebWorkers associated with the page.
+This method returns an array of the dedicated [WebWorkers](/javascript-api/k6-experimental/browser/worker/) associated with the page.
 
 ### Example
 
