⚠️ remove unused v1alpha2 package and update doc

[sbueringer]

What this PR does / why we need it:

As we're not really (imho) supporting migrations from v1alpha2 to v1alpha3 and the v1alpha2 package was unused in our implementation I would suggest removing it. I'm happy when we have v1alpha3 finalized I don't think we have the bandwidth to support migrations explicitly right now

See also: #499

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: sbueringer

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [sbueringer]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[sbueringer]

/assign @hidekazuna
/assign @prankul88
/assign @jichenjc

[hidekazuna]

@sbueringer I agree we remove v1alpha2, I am not sure Cluster API policy though.
This PR seems conflict with #516 which drops v1alpha2 partially.

[sbueringer]

@sbueringer I agree we remove v1alpha2, I am not sure Cluster API policy though.
This PR seems conflict with #516 which drops v1alpha2 partially.

Shouldn't conflict. The goal of the other one was mainly to fix the makefile so our images after merge on master are build again, because that's broken for a while now. It's just that the regeneration with the new makefile removed a lot of v1alpha2 occurences. Ups I pushed one commit to many in the other PR :/

Afaik there is no official policy. Or at least it doesn't make sense to keep orphaned packages when we're not using them

[sbueringer]

I'll close this PR here and use just the other one to make it not even more complicated. Sorry :/