Update upgrade.md

Author: wbakker-11

powerapps-docs/sample-apps/return-to-workplace/upgrade.md

@@ -11,7 +11,7 @@ ms.reviewer: kvivek
 ---
 # Upgrade the Return to Work solution.
 
-This article provide step-by-step instructions on how to upgrade the existing Return to Work solution to the latest version. If you're deploying the solution for the first time, see [deploy solution](deploy.md) article.
+This article provide step-by-step instructions on how to upgrade the existing Return to Work solution to the latest version. If you're deploying the solution for the first time, see [deploy the solution](deploy.md) article.
 
 ## Prerequisites
 
@@ -21,7 +21,7 @@ This article provide step-by-step instructions on how to upgrade the existing Re
 
 - You must have installed the earlier version of **Return to the Workplace** and have the environment details. 
 
-- Upgrading the solution impacts the user experience, so it is advised to upgrade the solution outside of normal business hours and test this on a dev / test or qa environment. 
+- Upgrading the solution impacts the user experience, so it is advised to upgrade the solution outside of normal business hours and test this on a dev / test or uat environment. 
 
 ## Step 1: Update the Package
 
@@ -37,14 +37,59 @@ Update the **Return to the Workplace** solution via the Power Platform admin cen
 > ![Welcome screen](media/app-management-environment-view.png "Applications within the Admin Center")
 
   4. In the status of **Power Platform Return to the Workplace - Apps** will show **Update Available**. From the top menu bar you can select **Update** or select the **Update Available** status to start the update process. From the top menu bar you can also select **Details** to see the process of the installation.
+  
+For more details on the update process, view [manage Dynamics 365 apps](https://docs.microsoft.com/en-us/power-platform/admin/manage-apps).
 
 ## Step 2: Update the Power BI dashboards
 
-Yet to be documented based on experience.
+When a new version for **Return to the Workplace** becomes available, you will get notified in two ways:
+
+  - An update banner appears in the Power BI service informing you that a new app version is available. Template app update notification
+
+> [!div class="mx-imgBorder"]
+> ![Welcome screen](media/power-bi-new-app-version-notification-banner.png "Power BI Banner")
+
+  - You receive a notification in Power BI's notification pane.
+
+> [!div class="mx-imgBorder"]
+> ![Welcome screen](media/power-bi-new-app-version-notification-pane.png "Power BI Notification Pane")
+
+> [!NOTE]
+> If you originally got the app via direct link rather than through AppSource, the use the links in the [deploy the solution](deploy.md).
+
+To install the update, either click **Get it** on the notification banner or in the notification center, or find the app again in AppSource and choose **Get it now**. If you got a direct link for the update, simply click the link.
+
+You will be asked whether you wish to overwrite the current version, or to install the new version in a new workspace. By default, "overwrite" is selected.
+
+> [!div class="mx-imgBorder"]
+> ![Welcome screen](media/power-bi-update-app-overwrite.png "Update App overwrite")
+
+  - **Overwrite an existing version:** Overwrites the existing workspace with the updated version of the template app. See details about overwriting.
+
+  - **Install to a new workspace:** Installs a fresh version of the workspace and app that you need to reconfigure (that is, connect to data, define navigation and permissions).
+
+###Overwrite behavior
+  - Overwriting updates the reports, dashboards, and dataset inside the workspace, not the app. Overwriting doesn't change app navigation, setup, and permissions.
+
+  - After you update the workspace, you need to update the app to apply changes from the workspace to the app.
+
+  - Overwriting keeps configured parameters and authentication. After update, an automatic dataset refresh starts. During this refresh, the app, reports, and dashboards present sample data.
+
+> [!div class="mx-imgBorder"]
+> ![Welcome screen](media/power-bi-sample-data.png "Sample Data")
+
+  - Overwriting always presents sample data until the refresh is complete. If the template app author made changes to the dataset or parameters, users of the workspace and app will not see the new data until the refresh is complete. Rather, they will continue to see sample data during this time.
+
+  - Overwriting never deletes new reports or dashboards you've added to the workspace. It only overwrites the original reports and dashboards with changes from the original author.
+
+> [!NOTE]
+> Remember to update the app after overwriting to apply changes to the reports and dashboard for your organizational app users.
+
+For more details on the update process, view [update a template app](https://docs.microsoft.com/en-us/power-bi/connect-data/service-template-apps-install-distribute#update-a-template-app)
 
 ## Step 3: Install the Workplace Care Management Dashboard
 
-Included in the next version is a new dashboard for the **Heath and Safety Leads**, this dashboard gives you a single overview where you can track employee cases. You can view more details in [use the case management dashboard](dashboard-case-management.md), to install it follow the instructions as provided in the [deploy the solution](deploy.md#step-3-configure-and-publish-power-bi-dashboards).
+Included in the next version is a new dashboard for the **Health and Safety Leads**, this dashboard gives you a single overview where you can track employee cases. You can view more details in [use the case management dashboard](dashboard-case-management.md), to install it follow the instructions as provided in the [deploy the solution](deploy.md#step-3-configure-and-publish-power-bi-dashboards).
 
 ## Step 4: Update the Facilities
 
@@ -60,4 +105,4 @@ Employee cases are made inactive when they are finished starting from this relea
 
 ## Appendix: Update the app and publish Power BI dashboard (US Government customers only)
 
-For GCC customers, we still support the process outside of AppSource, before executing the steps above you need to follow **Appendix: Deploy the app and publish Power BI dashboard (US Government customers only)** in the [Deploy the solution](deploy.md) page.
+For GCC customers, we still support the process outside of AppSource, before executing the steps above you need to follow **Appendix: Deploy the app and publish Power BI dashboard (US Government customers only)** in the [deploy the solution](deploy.md) page.