diff --git a/src/common/Browser.ts b/src/common/Browser.ts
index 153c545b7884f..d9c9d29737a1f 100644
--- a/src/common/Browser.ts
+++ b/src/common/Browser.ts
@@ -417,7 +417,8 @@ export class Browser extends EventEmitter {
   }
 
   /**
-   * Creates a {@link Page} in the default browser context.
+   * Promise which resolves to a new {@link Page} object. The Page is created in
+   * a default browser context.
    */
   async newPage(): Promise<Page> {
     return this._defaultContext.newPage();
diff --git a/src/node/BrowserFetcher.ts b/src/node/BrowserFetcher.ts
index 0d22e3386a403..20301e2462142 100644
--- a/src/node/BrowserFetcher.ts
+++ b/src/node/BrowserFetcher.ts
@@ -220,14 +220,16 @@ export class BrowserFetcher {
   }
 
   /**
-   * @returns Returns the current `Platform`.
+   * @returns Returns the current `Platform`, which is one of `mac`, `linux`,
+   * `win32` or `win64`.
    */
   platform(): Platform {
     return this._platform;
   }
 
   /**
-   * @returns Returns the current `Product`.
+   * @returns Returns the current `Product`, which is one of `chrome` or
+   * `firefox`.
    */
   product(): Product {
     return this._product;
diff --git a/tsconfig.json b/tsconfig.json
index d35ef12857dcf..0fe7e06ad83c7 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -7,8 +7,9 @@
   "extends": "./tsconfig.base.json",
   "compilerOptions": {
     "noEmit": true,
-    // This module setting is just for VSCode so it doesn't error when we use
-    // dynamic imports.
+    /*  This module setting is just for VSCode so it doesn't throw error when we
+        use dynamic imports.
+     */
     "module": "esnext"
   },
   "include": ["src"]