(Capacitor): Add migration guide for new version

[lucas-zimerman]

DESCRIBE YOUR PR

The next major version of Sentry Capacitor will also use Sentry Javascript SDK V8 where both includes break changes, this PR aims to add a migration guide for both Capacitor and the Sibling SDKs.

I also removed the deprecated setup of Capacitor 2 that we will no longer support and also a small refactor on v8-new-performance-api to make the file smaller to read on the code review.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

• Urgent deadline (GA date, etc.):
• Other deadline:
• None: Not urgent, can wait up to 1 week+

SLA

• Teamwork makes the dream work, so please add a reviewer to your PRs.
• Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
  Thanks in advance for your help!

PRE-MERGE CHECKLIST

I checked that locally it is building and displaying correctly.

Make sure you've checked the following before merging your changes:

• Checked Vercel preview for correctness, including links
• PR was reviewed and approved by any necessary SMEs (subject matter experts)
• PR was reviewed and approved by a member of the Sentry docs team

LEGAL BOILERPLATE

EXTRA RESOURCES

• Sentry Docs contributor guide

[vercel]

@lucas-zimerman is attempting to deploy a commit to the Sentry Team on Vercel.

A member of the Team first needs to authorize it.

[lucas-zimerman]

@krystofwoldrich @kahest

Should I also add an information like this? https://docs.sentry.io/platforms/javascript/guides/angular/#angular-version-compatibility

despite the page mentioning that older versions of Angular should use V7, the docs only only shows the documentation of V8 so it may generate confusion to users sticking with V7.

Our Capacitor SDK only supports Angular as low as 10, so we could mention that users should stick with Capacitor V0 for Angular 10 to - 13 and V1 for Angular 14 or higher.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
changelog	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Aug 16, 2024 0:36am
sentry-docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Aug 16, 2024 0:36am

1 Skipped Deployment

Name	Status	Preview	Comments	Updated (UTC)
develop-docs	⬜️ Ignored (Inspect)	Visit Preview		Aug 16, 2024 0:36am

[kahest]

@chargome I added @getsentry/team-web-sdk-frontend as reviewer - please rope in other reviewers if needed 🙏

[kahest]

@krystofwoldrich @kahest

Should I also add an information like this? docs.sentry.io/platforms/javascript/guides/angular#angular-version-compatibility

despite the page mentioning that older versions of Angular should use V7, the docs only only shows the documentation of V8 so it may generate confusion to users sticking with V7.

Our Capacitor SDK only supports Angular as low as 10, so we could mention that users should stick with Capacitor V0 for Angular 10 to - 13 and V1 for Angular 14 or higher.

Yes I think that would help users understand 👍

[krystofwoldrich]

Besides the Angular versions mentioned above, the guide migration guide looks good!

[lforst]

Thanks!

[krystofwoldrich]

Looks good! Thank you! 🚀