puppeteer · jackfranklin · Jun 24, 2020 · Jun 23, 2020 · Jun 23, 2020 · Jun 24, 2020
diff --git a/new-docs/puppeteer.browser.md b/new-docs/puppeteer.browser.md
@@ -9,7 +9,6 @@
 ```typescript
 export declare class Browser extends EventEmitter 
 ```
-<b>Extends:</b> [EventEmitter](./puppeteer.eventemitter.md)
 
 ## Constructors
 

diff --git a/new-docs/puppeteer.browsercontext.md b/new-docs/puppeteer.browsercontext.md
@@ -9,7 +9,6 @@
 ```typescript
 export declare class BrowserContext extends EventEmitter 
 ```
-<b>Extends:</b> [EventEmitter](./puppeteer.eventemitter.md)
 
 ## Constructors
 

diff --git a/new-docs/puppeteer.browserfetcher._constructor_.md b/new-docs/puppeteer.browserfetcher._constructor_.md
diff --git a/new-docs/puppeteer.browserfetcher._getfolderpath.md b/new-docs/puppeteer.browserfetcher._getfolderpath.md
diff --git a/new-docs/puppeteer.browserfetcher.candownload.md b/new-docs/puppeteer.browserfetcher.candownload.md
@@ -4,6 +4,8 @@
 
 ## BrowserFetcher.canDownload() method
 
+Initiates a HEAD request to check if the revision is available.
+
 <b>Signature:</b>
 
 ```typescript
@@ -14,9 +16,15 @@ canDownload(revision: string): Promise<boolean>;
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
-|  revision | string |  |
+|  revision | string | The revision to check availability for. |
 
 <b>Returns:</b>
 
 Promise&lt;boolean&gt;
 
+A promise that resolves to `true` if the revision could be downloaded from the host.
+
+## Remarks
+
+This method is affected by the current `product`<!-- -->.
+
diff --git a/new-docs/puppeteer.browserfetcher.download.md b/new-docs/puppeteer.browserfetcher.download.md
@@ -4,6 +4,8 @@
 
 ## BrowserFetcher.download() method
 
+Initiates a GET request to download the revision from the host.
+
 <b>Signature:</b>
 
 ```typescript
@@ -14,12 +16,16 @@ download(revision: string, progressCallback: (x: number, y: number) => void): Pr
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
-|  revision | string |  |
-|  progressCallback | (x: number, y: number) =&gt; void |  |
+|  revision | string | The revision to download. |
+|  progressCallback | (x: number, y: number) =&gt; void | A function that will be called with two arguments: How many bytes have been downloaded and the total number of bytes of the download. |
 
 <b>Returns:</b>
 
 Promise&lt;BrowserFetcherRevisionInfo&gt;
 
-{<!-- -->!Promise<!-- -->&lt;<!-- -->!BrowserFetcher.RevisionInfo<!-- -->&gt;<!-- -->}
+A promise with revision information when the revision is downloaded and extracted.
+
+## Remarks
+
+This method is affected by the current `product`<!-- -->.
 
diff --git a/new-docs/puppeteer.browserfetcher.host.md b/new-docs/puppeteer.browserfetcher.host.md
@@ -13,3 +13,5 @@ host(): string;
 
 string
 
+The download host being used.
+
diff --git a/new-docs/puppeteer.browserfetcher.localrevisions.md b/new-docs/puppeteer.browserfetcher.localrevisions.md
@@ -13,3 +13,9 @@ localRevisions(): Promise<string[]>;
 
 Promise&lt;string\[\]&gt;
 
+A promise with a list of all revision strings (for the current `product`<!-- -->) available locally on disk.
+
+## Remarks
+
+This method is affected by the current `product`<!-- -->.
+
diff --git a/new-docs/puppeteer.browserfetcher.md b/new-docs/puppeteer.browserfetcher.md
@@ -4,25 +4,38 @@
 
 ## BrowserFetcher class
 
+BrowserFetcher can download and manage different versions of Chromium and Firefox.
+
 <b>Signature:</b>
 
 ```typescript
 export declare class BrowserFetcher 
 ```
 
-## Constructors
+## Remarks
 
-|  Constructor | Modifiers | Description |
-|  --- | --- | --- |
-|  [(constructor)(projectRoot, options)](./puppeteer.browserfetcher._constructor_.md) |  | Constructs a new instance of the <code>BrowserFetcher</code> class |
+BrowserFetcher operates on revision strings that specify a precise version of Chromium, e.g. `"533271"`<!-- -->. Revision strings can be obtained from \[omahaproxy.appspot.com\](http://omahaproxy.appspot.com/). In the Firefox case, BrowserFetcher downloads Firefox Nightly and operates on version numbers such as `"75"`<!-- -->.
+
+The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `BrowserFetcher` class.
+
+## Example
+
+An example of using BrowserFetcher to download a specific version of Chromium and running Puppeteer against it:
+
+```js
+const browserFetcher = puppeteer.createBrowserFetcher();
+const revisionInfo = await browserFetcher.download('533271');
+const browser = await puppeteer.launch({executablePath: revisionInfo.executablePath})
+
+```
+\*\*NOTE\*\* BrowserFetcher is not designed to work concurrently with other instances of BrowserFetcher that share the same downloads directory.
 
 ## Methods
 
 |  Method | Modifiers | Description |
 |  --- | --- | --- |
-|  [\_getFolderPath(revision)](./puppeteer.browserfetcher._getfolderpath.md) |  |  |
-|  [canDownload(revision)](./puppeteer.browserfetcher.candownload.md) |  |  |
-|  [download(revision, progressCallback)](./puppeteer.browserfetcher.download.md) |  |  |
+|  [canDownload(revision)](./puppeteer.browserfetcher.candownload.md) |  | Initiates a HEAD request to check if the revision is available. |
+|  [download(revision, progressCallback)](./puppeteer.browserfetcher.download.md) |  | Initiates a GET request to download the revision from the host. |
 |  [host()](./puppeteer.browserfetcher.host.md) |  |  |
 |  [localRevisions()](./puppeteer.browserfetcher.localrevisions.md) |  |  |
 |  [platform()](./puppeteer.browserfetcher.platform.md) |  |  |

diff --git a/new-docs/puppeteer.browserfetcher.platform.md b/new-docs/puppeteer.browserfetcher.platform.md
@@ -13,3 +13,5 @@ platform(): string;
 
 string
 
+One of `mac`<!-- -->, `linux`<!-- -->, `win32` or `win64`<!-- -->.
+
diff --git a/new-docs/puppeteer.browserfetcher.product.md b/new-docs/puppeteer.browserfetcher.product.md
@@ -13,3 +13,5 @@ product(): string;
 
 string
 
+One of `chrome` or `firefox`<!-- -->.
+
diff --git a/new-docs/puppeteer.browserfetcher.remove.md b/new-docs/puppeteer.browserfetcher.remove.md
@@ -14,9 +14,15 @@ remove(revision: string): Promise<void>;
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
-|  revision | string |  |
+|  revision | string | A revision to remove for the current <code>product</code>. |
 
 <b>Returns:</b>
 
 Promise&lt;void&gt;
 
+A promise that resolves when the revision has been removes or throws if the revision has not been downloaded.
+
+## Remarks
+
+This method is affected by the current `product`<!-- -->.
+
diff --git a/new-docs/puppeteer.browserfetcher.revisioninfo.md b/new-docs/puppeteer.browserfetcher.revisioninfo.md
@@ -14,9 +14,11 @@ revisionInfo(revision: string): BrowserFetcherRevisionInfo;
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
-|  revision | string |  |
+|  revision | string | The revision to get info for. |
 
 <b>Returns:</b>
 
 BrowserFetcherRevisionInfo
 
+The revision info for the given revision.
+
diff --git a/new-docs/puppeteer.cdpsession.md b/new-docs/puppeteer.cdpsession.md
@@ -9,7 +9,6 @@
 ```typescript
 export declare class CDPSession extends EventEmitter 
 ```
-<b>Extends:</b> [EventEmitter](./puppeteer.eventemitter.md)
 
 ## Constructors
 

diff --git a/new-docs/puppeteer.connection.md b/new-docs/puppeteer.connection.md
@@ -9,7 +9,6 @@
 ```typescript
 export declare class Connection extends EventEmitter 
 ```
-<b>Extends:</b> [EventEmitter](./puppeteer.eventemitter.md)
 
 ## Constructors
 

diff --git a/new-docs/puppeteer.elementhandle.md b/new-docs/puppeteer.elementhandle.md
@@ -9,7 +9,6 @@
 ```typescript
 export declare class ElementHandle extends JSHandle 
 ```
-<b>Extends:</b> [JSHandle](./puppeteer.jshandle.md)
 
 ## Constructors
 

diff --git a/new-docs/puppeteer.eventemitter.md b/new-docs/puppeteer.eventemitter.md
@@ -11,7 +11,6 @@ The EventEmitter class that many Puppeteer classes extend.
 ```typescript
 export declare class EventEmitter implements CommonEventEmitter 
 ```
-<b>Implements:</b> CommonEventEmitter
 
 ## Remarks
 

diff --git a/new-docs/puppeteer.framemanager.md b/new-docs/puppeteer.framemanager.md
@@ -9,7 +9,6 @@
 ```typescript
 export declare class FrameManager extends EventEmitter 
 ```
-<b>Extends:</b> [EventEmitter](./puppeteer.eventemitter.md)
 
 ## Constructors
 

diff --git a/new-docs/puppeteer.md b/new-docs/puppeteer.md
@@ -11,7 +11,7 @@
 |  [Accessibility](./puppeteer.accessibility.md) | The Accessibility class provides methods for inspecting Chromium's accessibility tree. The accessibility tree is used by assistive technology such as [screen readers](https://en.wikipedia.org/wiki/Screen_reader) or [switches](https://en.wikipedia.org/wiki/Switch_access)<!-- -->. |
 |  [Browser](./puppeteer.browser.md) |  |
 |  [BrowserContext](./puppeteer.browsercontext.md) |  |
-|  [BrowserFetcher](./puppeteer.browserfetcher.md) |  |
+|  [BrowserFetcher](./puppeteer.browserfetcher.md) | BrowserFetcher can download and manage different versions of Chromium and Firefox. |
 |  [CDPSession](./puppeteer.cdpsession.md) |  |
 |  [Connection](./puppeteer.connection.md) |  |
 |  [ConsoleMessage](./puppeteer.consolemessage.md) |  |

diff --git a/new-docs/puppeteer.page.md b/new-docs/puppeteer.page.md
@@ -11,7 +11,6 @@ Page provides methods to interact with a single tab or \[extension background pa
 ```typescript
 export declare class Page extends EventEmitter 
 ```
-<b>Extends:</b> [EventEmitter](./puppeteer.eventemitter.md)
 
 ## Remarks
 

diff --git a/new-docs/puppeteer.timeouterror.md b/new-docs/puppeteer.timeouterror.md
@@ -11,7 +11,6 @@ TimeoutError is emitted whenever certain operations are terminated due to timeou
 ```typescript
 export declare class TimeoutError extends CustomError 
 ```
-<b>Extends:</b> CustomError
 
 ## Remarks
 

diff --git a/new-docs/puppeteer.webworker.md b/new-docs/puppeteer.webworker.md
@@ -11,7 +11,6 @@ The WebWorker class represents a [WebWorker](https://developer.mozilla.org/en-US
 ```typescript
 export declare class WebWorker extends EventEmitter 
 ```
-<b>Extends:</b> [EventEmitter](./puppeteer.eventemitter.md)
 
 ## Remarks