add migration docs

Author: mydea

MIGRATION.md

@@ -8,6 +8,13 @@ npx @sentry/migr8@latest
 
 This will let you select which updates to run, and automatically update your code. Make sure to still review all code changes!
 
+## Deprecated fields on `Span` and `Transaction`
+
+In v8, the Span class is heavily reworked. The following properties & methods are thus deprecated:
+
+* `span.toContext()`: Access the fields directly instead.
+* `span.updateWithContext(newSpanContext)`: Update the fields directly instead.
+
 ## Deprecate `pushScope` & `popScope` in favor of `withScope`
 
 Instead of manually pushing/popping a scope, you should use `Sentry.withScope(callback: (scope: Scope))` instead.