diff --git a/packages/browser-sdk/README.md b/packages/browser-sdk/README.md
index 80ae6d2d..a64ad6dd 100644
--- a/packages/browser-sdk/README.md
+++ b/packages/browser-sdk/README.md
@@ -320,6 +320,13 @@ The two cookies are:
 - `bucket-prompt-${userId}`: store the last automated feedback prompt message ID received to avoid repeating surveys
 - `bucket-token-${userId}`: caching a token used to connect to Bucket's live messaging infrastructure that is used to deliver automated feedback surveys in real time.
 
+### Upgrading to 3.0 from 2.x
+
+Breaking changes:
+
+- `client.onFeaturesUpdated()` is now replaced by [event listeners](#event-listeners)
+- Arguments to the `BucketClient` constructor which were previously under `featureOptions` are now supplied directly in the root.
+
 ### TypeScript
 
 Types are bundled together with the library and exposed automatically when importing through a package manager.
diff --git a/packages/browser-sdk/src/client.ts b/packages/browser-sdk/src/client.ts
index 16ef9302..85d36d5e 100644
--- a/packages/browser-sdk/src/client.ts
+++ b/packages/browser-sdk/src/client.ts
@@ -805,8 +805,6 @@ export class BucketClient {
   /**
    * Stop the SDK.
    * This will stop any automated feedback surveys.
-   * It will also stop the features client, including removing
-   * any onFeaturesUpdated listeners.
    *
    **/
   async stop() {