"Migrate Kubernetes Objects Using Storage Version Migration" is unclear

[porridge]

It seems like the #update-the-preferred-storage-schema-of-a-crd example contains a contradiction.

At the beginning:

Before setting v2 as the preferred storage schema version, it's important to ensure that all existing CRs stored as v1 are migrated to v2.

However the text seems to be doing the exact opposite: first change storage to true on v2, and then create a StorageVersionMigration.

Or am I misunderstanding something? But even if I am, others might as well 😅

[k8s-ci-robot]

This issue is currently awaiting triage.

SIG Docs takes a lead on issue triage for this website, but any Kubernetes member can accept issues by applying the triage/accepted label.

The triage/accepted label can be added by org members by writing /triage accepted in a comment.

Instructions for interacting with me using PR comments are available [here](https://git.k8s.io/community/contributors/guide/pull-requests.md). If you have questions or suggestions related to my behavior, please file an issue against the [kubernetes-sigs/prow](https://github.com/kubernetes-sigs/prow/issues/new?title=Prow%20issue:) repository.

[tamilselvan1102]

/language en

[tamilselvan1102]

Related page: https://kubernetes.io/docs/tasks/manage-kubernetes-objects/storage-version-migration/#update-the-preferred-storage-schema-of-a-crd

[sftim]

/retitle "Migrate Kubernetes Objects Using Storage Version Migration" is unclear /sig api-machinery