refactor: add migration guide

[magicmatatjahu]

Description

Add migration guide v1 -> v2.

Some sections will have to be updated before release.

cc @smoya @jonaslagoni @derberg @fmvilas

Related issue(s)
Part of #481
Part of #482

[github-actions]

This pull request has been automatically marked as stale because it has not had recent activity 😴

It will be closed in 120 days if no further activity occurs. To unstale this pull request, add a comment with detailed explanation.

There can be many reasons why some specific pull request has no activity. The most probable cause is lack of time, not lack of interest. AsyncAPI Initiative is a Linux Foundation project not owned by a single for-profit company. It is a community-driven initiative ruled under open governance model.

Let us figure out together how to push this pull request forward. Connect with us through one of many communication channels we established here.

Thank you for your patience ❤️

[smoya]

Still relevant. cc @magicmatatjahu

[sonarcloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

No Coverage information
No Duplication information

[smoya]

@magicmatatjahu you need to change the base branch to be master now since the Parser has been merged.

The base branch was changed.

[smoya]

@magicmatatjahu After changing base branch to master, now it has conflicts. I think the best is to just reset --hard to the HEAD of master and do cherry-pick of the commit(s) that adds the migration guide.

[jonaslagoni]

This really should have been resolved before we released v2 of the parser.

[jonaslagoni]

Re-creating