Existing doc page (covers only operator upgrade - via inplace/canary): https://docs.redhat.com/en/documentation/red_hat_openshift_service_mesh/3.0/html/updating/ossm-updating-openshift-service-mesh#ossm-updating-openshift-service-mesh.

Drafted complete documentation (covers full upgrade path with explanations): https://github.com/openshift-service-mesh/sail-operator/tree/main/docs/ossm/versioning-and-upgrades

Old description:

This exists already, but only covers updating the Istio control plane (which is only part of the procedure): https://docs.openshift.com/service-mesh/latest/update/ossm-updating-openshift-service-mesh.html

From end to end, this page should include:

• About Istio control plane update strategies (not to be confused with operator update strategies)
• Procedure: Updating the Istio control plane with InPlace strategy (existing content, upstream content)

Note: Existing content should be reviewed against the upstream content as well, as it may have changed.