feat: update README.md for upgrade instructions

Signed-off-by: Kimonas Sotirchos <[email protected]>

Author: kimwnasptd

README.md

@@ -6,7 +6,7 @@
 It exposes the access controlled web interfaces for Kubeflow components and more.
 
 > ⚠️ __Note__ ⚠️
-> 
+>
 > We are currently moving the Kubeflow Dashboard codebase from [`kubeflow/kubeflow`](https://github.com/kubeflow/kubeflow) to this repository ([`kubeflow/dashboard`](https://github.com/kubeflow/dashboard)).
 > Please see [`kubeflow/kubeflow#7549`](https://github.com/kubeflow/kubeflow/issues/7549) for more information.
 
@@ -38,6 +38,34 @@ Please refer to the [Installing Kubeflow](https://www.kubeflow.org/docs/started/
 
 The official documentation for Kubeflow Dashboard can be found [here](https://www.kubeflow.org/docs/components/central-dash/).
 
+## Migrate from V1
+
+In the past, up until the Kubeflow 1.10 release, the components hosed in this repo were living in the
+[`kubeflow/kubeflow`](https://github.com/kubeflow/kubeflow) repository.
+
+To accomodate the migration, the first `v2.0.0` release of this repository contains the same artifacts
+from the corresponding [`v1.10.0`](https://github.com/kubeflow/kubeflow/releases/tag/v1.10.0) tag from the `kubeflow/kubeflow` repo. This was done to ensure a smooth transition
+between the components of the different repos. You can find more details about the migration in https://github.com/kubeflow/dashboard/issues/118.
+
+### Prerequisites
+
+1. A Kubeflow cluster with 1.10.0 or above
+2. `kubectl` configured for access to the above cluster
+
+### Script
+
+You can use the following script to perform the migration from `v1.10.0` components to the `v2.0.0` ones from this repo. The script will
+perform the following actions:
+1. Remove the existing components of CentralDashboard, Profiles Controller and PodDefaults Webhook
+    * The script will not remove any CR or CRD, to ensure no data loss
+    * Only K8s resources relevant to the Deployments will be removed (Deployment, ServiceAccount, Service etc)
+    * The [`NetworkPolicy`](https://github.com/kubeflow/manifests/blob/v1.10-branch/common/networkpolicies/base/centraldashboard.yaml) from the `kubeflow/manifests` repo, of the CentralDashboard, will be removed
+2. Install the manifests from this repo for the Dashboard, Profiles Controller and PodDefaults webhook
+
+```bash
+./scripts/upgrade_v1_to_v1.sh
+```
+
 ## Community
 
 Kubeflow Dashboard is part of the Kubeflow project, refer to the [Kubeflow Community](https://www.kubeflow.org/docs/about/community/) page for more information.