diff --git a/UPGRADE-3.0.md b/UPGRADE-3.0.md
index a9e9d5c3..bb87ee07 100644
--- a/UPGRADE-3.0.md
+++ b/UPGRADE-3.0.md
@@ -8,6 +8,11 @@ The major change is in the fact that we now require the `sentry/sdk` metapackage
 This new version has been completely rewritten: if you use this bundle and you interact directly with the underlying SDK
 and client, you should read through the [relative upgrade document](https://github.com/getsentry/sentry-php/blob/master/UPGRADE-2.0.md).
 
+## Changes in the configuration
+There are only two BC impacting the configuration:
+ * the `skip_capture` option has been **removed**: the same feature has been implemented in the new SDK, with the PHP `excluded_exceptions` option; you just have to move your values from `sentry.skip_capture` to `sentry.options.excluded_exceptions`
+ * The `sentry.options` values reflect the options of the PHP SDK; many of those have been removed, and there are some new ones. You can read the [appropriate section of the upgrade document](https://github.com/getsentry/sentry-php/blob/master/UPGRADE-2.0.md#client-options), with the exception of the `server` to `dsn` migration, which is still handled in the same way by the bundle, under `sentry.dsn`
+
 ## HTTPlug
 Since SDK 2.0 uses HTTPlug to remain transport-agnostic, you need to have installed two packages that provides 
 [`php-http/async-client-implementation`](https://packagist.org/providers/php-http/async-client-implementation)