puppeteer · mathiasbynens · Jun 23, 2020 · Jun 22, 2020
diff --git a/new-docs/puppeteer.browser._closecallback.md b/new-docs/puppeteer.browser._closecallback.md
diff --git a/new-docs/puppeteer.browser._connection.md b/new-docs/puppeteer.browser._connection.md
diff --git a/new-docs/puppeteer.browser._constructor_.md b/new-docs/puppeteer.browser._constructor_.md
diff --git a/new-docs/puppeteer.browser._contexts.md b/new-docs/puppeteer.browser._contexts.md
diff --git a/new-docs/puppeteer.browser._createpageincontext.md b/new-docs/puppeteer.browser._createpageincontext.md
diff --git a/new-docs/puppeteer.browser._defaultcontext.md b/new-docs/puppeteer.browser._defaultcontext.md
diff --git a/new-docs/puppeteer.browser._defaultviewport.md b/new-docs/puppeteer.browser._defaultviewport.md
diff --git a/new-docs/puppeteer.browser._disposecontext.md b/new-docs/puppeteer.browser._disposecontext.md
diff --git a/new-docs/puppeteer.browser._getversion.md b/new-docs/puppeteer.browser._getversion.md
diff --git a/new-docs/puppeteer.browser._ignorehttpserrors.md b/new-docs/puppeteer.browser._ignorehttpserrors.md
diff --git a/new-docs/puppeteer.browser._process.md b/new-docs/puppeteer.browser._process.md
diff --git a/new-docs/puppeteer.browser._targetcreated.md b/new-docs/puppeteer.browser._targetcreated.md
diff --git a/new-docs/puppeteer.browser._targetdestroyed.md b/new-docs/puppeteer.browser._targetdestroyed.md
diff --git a/new-docs/puppeteer.browser._targetinfochanged.md b/new-docs/puppeteer.browser._targetinfochanged.md
diff --git a/new-docs/puppeteer.browser._targets.md b/new-docs/puppeteer.browser._targets.md
diff --git a/new-docs/puppeteer.browser.browsercontexts.md b/new-docs/puppeteer.browser.browsercontexts.md
@@ -4,6 +4,8 @@
 
 ## Browser.browserContexts() method
 
+Returns an array of all open browser contexts. In a newly created browser, this will return a single instance of [BrowserContext](./puppeteer.browsercontext.md)<!-- -->.
+
 <b>Signature:</b>
 
 ```typescript

diff --git a/new-docs/puppeteer.browser.close.md b/new-docs/puppeteer.browser.close.md
@@ -4,6 +4,8 @@
 
 ## Browser.close() method
 
+Closes Chromium and all of its pages (if any were opened). The [Browser](./puppeteer.browser.md) object itself is considered to be disposed and cannot be used anymore.
+
 <b>Signature:</b>
 
 ```typescript

diff --git a/new-docs/puppeteer.browser.create.md b/new-docs/puppeteer.browser.create.md
diff --git a/new-docs/puppeteer.browser.createincognitobrowsercontext.md b/new-docs/puppeteer.browser.createincognitobrowsercontext.md
@@ -4,6 +4,8 @@
 
 ## Browser.createIncognitoBrowserContext() method
 
+Creates a new incognito browser context. This won't share cookies/cache with other browser contexts.
+
 <b>Signature:</b>
 
 ```typescript
@@ -13,3 +15,19 @@ createIncognitoBrowserContext(): Promise<BrowserContext>;
 
 Promise&lt;[BrowserContext](./puppeteer.browsercontext.md)<!-- -->&gt;
 
+## Example
+
+
+```js
+(async () => {
+ const browser = await puppeteer.launch();
+  // Create a new incognito browser context.
+  const context = await browser.createIncognitoBrowserContext();
+  // Create a new page in a pristine context.
+  const page = await context.newPage();
+  // Do stuff
+  await page.goto('https://example.com');
+})();
+
+```
+
diff --git a/new-docs/puppeteer.browser.defaultbrowsercontext.md b/new-docs/puppeteer.browser.defaultbrowsercontext.md
@@ -4,6 +4,8 @@
 
 ## Browser.defaultBrowserContext() method
 
+Returns the default browser context. The default browser context cannot be closed.
+
 <b>Signature:</b>
 
 ```typescript

diff --git a/new-docs/puppeteer.browser.disconnect.md b/new-docs/puppeteer.browser.disconnect.md
@@ -4,6 +4,8 @@
 
 ## Browser.disconnect() method
 
+Disconnects Puppeteer from the browser, but leaves the Chromium process running. After calling `disconnect`<!-- -->, the [Browser](./puppeteer.browser.md) object is considered disposed and cannot be used anymore.
+
 <b>Signature:</b>
 
 ```typescript

diff --git a/new-docs/puppeteer.browser.isconnected.md b/new-docs/puppeteer.browser.isconnected.md
@@ -4,6 +4,8 @@
 
 ## Browser.isConnected() method
 
+Indicates that the browser is connected.
+
 <b>Signature:</b>
 
 ```typescript