Apply suggestions from code review

Co-authored-by: Ankur <[email protected]>
Co-authored-by: Andrey Slotin <[email protected]>

Author: 3 people

src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page.md

@@ -3,7 +3,7 @@ title: 'bringToFront()'
 excerpt: 'Browser module: page.bringToFront method'
 ---
 
-Activates the browser tab so that it comes into focus and actions can be performed against it.
+Activates the browser tab which brings the page in focus to allow actions to be performed onto it.
 
 
 ### Example

src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/bringToFront.md

@@ -1,6 +1,6 @@
 ---
-title: 'click(selector,[options)'
-excerpt: 'Browser module: page.click(selector,[options) method'
+title: 'click(selector[, options])'
+excerpt: 'Browser module: page.click(selector[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
@@ -9,7 +9,7 @@ Use locator-based [`locator.click([options])`](/javascript-api/k6-experimental/b
 
 </Blockquote>
 
-This method clicks an element matching a `selector`.
+This method clicks on an element matching a `selector`.
 
 <TableWithNestedRows>
 
@@ -44,7 +44,7 @@ export default async function () {
   const page = browser.newPage();
 
   await page.goto('https://test.k6.io/browser.php');
-  await Promise.all([page.click('#counter-button')]);
+  await page.click('#counter-button');
 }
 ```
 

src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/click--options--.md

@@ -1,11 +1,11 @@
 ---
-title: 'dispatchEvent(selector, type, eventInit, [options])'
-excerpt: 'Browser module: page.dispatchEvent(selector, type, eventInit, [options]) method'
+title: 'dispatchEvent(selector, type, eventInit[, options])'
+excerpt: 'Browser module: page.dispatchEvent(selector, type, eventInit[, options]) method'
 ---
 
 <Blockquote mod="note" title="">
 
-Use locator-based [`locator.dispatchEvent(type, eventInit, [options])`](/javascript-api/k6-experimental/browser/locator/dispatchevent/) instead.
+Use locator-based [`locator.dispatchEvent(type, eventInit[, options])`](/javascript-api/k6-experimental/browser/locator/dispatchevent/) instead.
 
 </Blockquote>
 

src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/dispatchEvent--options--.md

@@ -5,7 +5,7 @@ excerpt: 'Browser module: page.evaluateHandle(pageFunction[, arg]) method'
 
 Returns the value of the `pageFunction` invocation as a [JSHandle](/javascript-api/k6-experimental/browser/jshandle/). 
 
-The only difference between `page.evaluate` and `page.evaluateHandle` is that `page.evaluateHandle` returns [JSHandle](/javascript-api/k6-experimental/browser/jshandle/).
+The only difference between `page.evaluate()` and `page.evaluateHandle()` is that `page.evaluateHandle()` returns [JSHandle](/javascript-api/k6-experimental/browser/jshandle/).
 
 <TableWithNestedRows>
 

src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/evaluateHandle.md

@@ -1,6 +1,6 @@
 ---
-title: 'getAttribute(selector, name, [options])'
-excerpt: 'Browser module: page.getAttribute(selector, name, [options]) method'
+title: 'getAttribute(selector, name[, options])'
+excerpt: 'Browser module: page.getAttribute(selector, name[, options]) method'
 ---
 
 <Blockquote mod="note" title="">

src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/getattribute--options--.md

@@ -1,6 +1,6 @@
 ---
-title: 'goto(url, [options])'
-excerpt: 'Browser module: page.goto(url, [options]) method'
+title: 'goto(url[, options])'
+excerpt: 'Browser module: page.goto(url[, options]) method'
 ---
 
 Navigates to the specified URL and returns the main resource response.

src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/goto--options--.md

@@ -1,6 +1,6 @@
 ---
-title: 'press(selector, key, [options])'
-excerpt: 'Browser module: page.press(selector, key, [options]) method'
+title: 'press(selector, key[, options])'
+excerpt: 'Browser module: page.press(selector, key[, options]) method'
 ---
 
 <Blockquote mod="note" title="">

src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/press--options--.md

@@ -1,6 +1,6 @@
 ---
-title: 'selectOption(selector, values, [options])'
-excerpt: 'Browser module: page.selectOption(selector, values, [options]) method'
+title: 'selectOption(selector, values[, options])'
+excerpt: 'Browser module: page.selectOption(selector, values[, options]) method'
 ---
 
 <Blockquote mod="note" title="">

src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/10 Page/selectoption--options--.md

@@ -1,6 +1,6 @@
 ---
-title: 'setContent(html, [options])'
-excerpt: 'Browser module: page.setContent(html, [options]) method'
+title: 'setContent(html[, options])'
+excerpt: 'Browser module: page.setContent(html[, options]) method'
 ---
 
 Sets the supplied HTML string to the current page.