Sentry Dart and Flutter Migration guide

src/platforms/dart/migration.mdx

@@ -0,0 +1,21 @@
+---
+title: Migration Guide
+sidebar_order: 1000
+---
+
+## Migrating from `sentry` `4.0.x` to `sentry` `5.0.0`
+
+* Fix: Prefix classes with Sentry
+  * A couple of classes were often conflicting with user's code.
+    As a result, this change renames the following classes:
+    * `App` -> `SentryApp`
+    * `Browser` -> `SentryBrowser`
+    * `Device` -> `SentryDevice`
+    * `Gpu` -> `SentryGpu`
+    * `Integration` -> `SentryIntegration`
+    * `Message` -> `SentryMessage`
+    * `OperatingSystem` -> `SentryOperatingSystem`
+    * `Orientation` -> `SentryOrientation`
+    * `Request` -> `SentryRequest`
+    * `User` -> `SentryUser`
+    * `Orientation` -> `SentryOrientation`

src/platforms/flutter/migration.mdx

@@ -0,0 +1,12 @@
+---
+title: Migration Guide
+sidebar_order: 1000
+---
+
+## Migrating from `sentry_flutter` `4.0.x` to `sentry_flutter` `5.0.0`
+
+In addition to the changes introduced in [sentry](/platforms/dart/migration/):
+
+- `SentryFlutterOptions.enableLifecycleBreadcrumbs` was replaced with `SentryFlutterOptions.enableAppLifecycleBreadcrumbs`.
+- The Web Plugin Registrant import changed from `import 'package:sentry_flutter/src/sentry_flutter_web.dart';` to `import 'package:sentry_flutter/sentry_flutter_web.dart';`
+  - This change may lead to breaking changes. In most cases, however, this change won't lead to breaking changed because the referencing file is auto-generated.