Merge branch 'main' into mason/vercel-marketplace-docs

Author: masnwilliams

browsers/create-a-browser.mdx

@@ -100,3 +100,9 @@ finally:
 ```
 
 </CodeGroup>
+
+
+## Connection notes
+- **CDP connections** are meant to be long-lived but may eventually close. Websocket connections typically can remain active for up to 1 hour, after which they may close automatically. Browser sessions themselves are unaffected—reconnect to the same `cdp_ws_url` to continue using the browser.
+- Browsers persist independently of CDP. Depending on your browser [persistence](/browsers/persistence) or [timeout](/browsers/termination#timeouts-for-non-persisted-browsers) configuration, it will continue running even if the CDP connection closes. You can reconnect to the same `cdp_ws_url` if you're unexpectedly disconnected.
+- We recommend implementing reconnect logic, as network interruptions or lifecycle events can cause CDP sessions to close. Detect disconnects and automatically re-establish a CDP connection when this occurs.