Sentry Dart and Flutter Migration guide

src/platforms/dart/migration.mdx

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

src/platforms/flutter/migration.mdx

@@ -0,0 +1,15 @@
+---
+title: Migration Guide
+sidebar_order: 1000
+redirect_from:
+  - /platforms/flutter/migrate/
+---
+
+## Migrating from `sentry_dart` `4.0.x` to `sentry_dart` `5.0.0`
+
+In addition to the changes of [sentry_dart](/platforms/dart/migrate/)
+there are the following changes:
+
+- `SentryFlutterOptions.enableLifecycleBreadcrumbs` was removed. Use `SentryFlutterOptions.enableAppLifecycleBreadcrumbs` instead.
+- The Web Plugin Registrant import changed from 'package:sentry_flutter/src/sentry_flutter_web.dart'; to 'package:sentry_flutter/sentry_flutter_web.dart';
+  - This could lead to breaking changes. Typically it shouldn't because the referencing file is auto-generated.